常用函数-wp_schedule_event()

说明

计划某个钩子（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函数列表请见常用函数

分类：中文手册