在WordPress中使用wp-cron插件来设置定时任务(2)-木庄网络博客

按周期循环预定安排一个 WordPress 勾子, 在预定时间触发勾子对应的函数.

<?php wp_schedule_event($timestamp, $recurrence, $hook, $args); ?>

$timestamp: 时间 (整型)
$recurrence: 循环周期类别 (hourly, twicedaily, daily, ...)
$hook: 勾子别名
$args: 勾子对应函数的参数数组 (可选)

wp_reschedule_event

按周期循环重新预定安排一个 WordPress 勾子. 但我发现这个方法不能正常使用, Codex 写得很草, 如果哪位清楚知道怎么使用, 请告知一下.

wp_unschedule_event

通过预定时间和勾子别名, 取消预定的安排.

<?php wp_unschedule_event($timestamp, $hook, $args ); ?>
$timestamp: 时间 (整型)
$hook: 勾子别名
$args: 勾子对应函数的参数数组 (可选)

wp_clear_scheduled_hook

通过勾子别名, 移除预定安排的勾子.

<?php wp_clear_scheduled_hook( $hook ); ?>
$hook: 勾子别名

wp_schedule_single_event

预定安排一个 WordPress 勾子, 在预定时间触发勾子对应的函数. 与 wp_schedule_event 不同的是该方法的只安排一次触发, 不存在循环预定.

<?php wp_schedule_single_event($timestamp, $hook); ?>

$timestamp: 时间 (整型)
$args: 勾子对应函数的参数数组 (可选)

从上面的函数可用的参数来看，我们就可以整理出以下几个常用的参数：

参数

$timestamp

（整数）（必须）第一次执行此定时任务的时间，需要传一个时间戳，一般情况下都是当场执行，但不能用 time() 函数，而是用 WordPress 的时间函数 current_time()。

默认值：None

$recurrence

（字符串）（必须）执行频率。每隔多长时间执行一次。可以填写 hourly （每小时执行一次）、twicedaily （每天执行两次，也就是 12 小时执行一次）和 daily （24 小时执行一次）。

默认值：None

$hook

（字符串）（必须）执行的钩子。在执行定时任务的时候会调用这个钩子，往这个钩子挂在函数即可实现定时执行函数。
默认值：None

$args

（数组）（可选）传递的参数，会被传递到挂载到定时钩子的函数里的参数。

默认值：None

返回值

（布尔 | null）如果添加成功则返回 null，不成功则返回 False

例子

if( !wp_next_scheduled( 'test' ) ) wp_schedule_event( current_time( 'timestamp' ), 'twicedaily', 'test' );

首先使用 wp_next_scheduled() 函数判断是否已经创建，如果没创建则创建一个定时任务。

把需要执行的代码挂载到 test 钩子上就行了。

标签：WordPress

在WordPress中使用wp-cron插件来设置定时任务