常用函数-wp_schedule_event()

0条评论

说明

计划某个钩子(hook)的运行周期,用户指定时间周期后,WordPress动作(action)函数每一周期内执行一次该钩子。预定时间过去后,如果有人访问用户的WordPress网站,动作函数钩子会被触发。插件API中有一份钩子(hook)列表。

用法

<?php wp_schedule_event(time(), 'hourly', 'my_schedule_hook'); ?> 

参数

$timestamp

(整数)(必需)希望事件首次发生的时间,时间格式必须为UNIX时间标记格式

默认值:None

$recurrance

(字符串)(必需)事件再次发生与上一次发生的时间间隔。可用值包括:

  • hourly
  • twicedaily
  • daily

默认值:None

$hook

(字符串)(必需)需要被执行的动作钩子的名称

默认值:None

$args

(数组)(可选)传递给钩子函数的参数

默认值:None

示例

计划一个每小时发生一次的事件

在插件中计划使某个事件每小时发生一次,可以用wp_schedule_event激活该事件(否则最后会出现很多计划的事件):

register_activation_hook(__FILE__, 'my_activation');
add_action('my_hourly_event', 'do_this_hourly');

function my_activation() {
	wp_schedule_event(time(), 'hourly', 'my_hourly_event');
}

function do_this_hourly() {
	// do something every hour
}

不要忘了取消激活,消除定时程序:

register_deactivation_hook(__FILE__, 'my_deactivation');

function my_deactivation() {
	wp_clear_scheduled_hook('my_hourly_event');
}

延伸阅读

其它定时进程函数请见 WP-Cron functions

完整WordPress函数列表请见常用函数