我们知道 Linux 服务器有个 crontab 的功能,可以让你定时去执行一些作业,但是并不是每个人都对 Linux 系统很熟悉,并且不是所有的主机管理面板都有 crontab 这个栏目。其实 WordPress 本身也有类似于 crontab 的功能,让你可以直接在 WordPress 后台执行安排好任何,定时执行。
WP-Cron 功能是基于页面浏览的,所以时间上不会那么准确,会相差一些,但是随着博客流量增大,这个准确度会越来越高的。比如 WordPress 本身的文章预发布功能就是基于 WP-Cron 实现的。WP-Cron 还定义一套完整的 API,让开发者可以自己通过插件的方式定义一些作业定时执行,需要开发者定义好任务执行的频率和回调函数。
WP-Cron 支持两种类型的任务:
- 单一的未来事件(比如设定某篇文章在将来某个时间发布)
- 重复发生的事件,比如每天,每个星期等一段时间内重复发生的事件(比如定时抓取某个博客的 RSS 源)
定义单一的未来事件
我们可以使用函数 wp_schedule_single_event( $timestamp, $hook, $args ) 来定义单一的未来事件:
- $timestamp :事件发生时的时间戳。
- $hook :事件调用的回调函数(大部分应该在1分钟内完成)
- $args :传给回调函数的参数数组,这个参数是可选的。
定义重复发生的事件
我们可以使用函数 wp_schedule_event( $timestamp, $recurrence, $hook, $args ) 来定义重复发生的时间。
- $timestamp , $hook 和 $args 这三个参数含义和 wp_schedule_single_event 。
- $recurrence :事件重复的频率。
WordPress 已经内置了两种重复频率 — huorly 和 daily。
但是如果还不够用,比如你定义每周发生的时间,比如:weekly。WP-Cron 也支持自定义事件频率类型。
首先我们可以使用函数 wp_get_schedules() 得到关于‘hourly’ 和 ‘daily’ 的信息,使用 print_r() 打印这个函数的输出:
Array ( [hourly] => Array ( [interval] => 3600 [display] => Once Hourly ) [daily] => Array ( [interval] => 86400 [display] => Once Daily ) )
从上面的代码,我们可以很清楚的知道,这个频率内部是使用秒数来定义的。从 wp_get_schedules() 的源代码,我们可以通过 cron_schedule 这个 filter 去自定义频率类型,比如我们定义每周和每半月的频率类型:
function hliang_more_reccurences() { return array( 'weekly' => array('interval' => 604800, 'display' => 'Once Weekly'), 'fortnightly' => array('interval' => 1209600, 'display' => 'Once Fortnightly'), ); } add_filter('cron_schedules', 'hliang_more_reccurences');
我们定义每天都要做的一个事件: wpjam_daily_function_hook()
if (!wp_next_scheduled('hliang_daily_function_hook')) { wp_schedule_event( time(), 'daily', 'hliang_daily_function_hook' ); }
就像上面所说的,‘hliang_daily_function_hook’ 这个函数会被调用,并且只需调用一次,这就是为什么去检查 wp_next_scheduled(‘my_daily_function_hook’) 返回的结果,如果已经安排返回下次安排的时间,如果没有被安排返回否,我们要确保事件只被安排一次。
上面定义好了事件,现在我们需要定义一个函数 hliang_daily_function() 去执行具体的功能:
add_action( 'hliang_daily_function_hook', 'hliang_daily_function'); function hliang_daily_function() { print "I was just called. I'll be called at the same time tomorrow"; }
这样在每天相同时间,第二个浏览站点任何页面的人将看到有文字显示在页面上。