WordPress函数自定义事件wp_schedule_single_event

WordPress函数wp_schedule_single_event()的功能是为WordPress添加一个只运行一次的事件。经常使用在长时间的耗时任务中，比如批量发送邮件，批量修改数据等等。

该函数位于：wp-includes/cron.php文件中

官方描述

安排 WordPress 在指定的 UTC 时间触发的挂钩。
如果预定时间已过，当有人访问您的 WordPress 网站时，该操作就会触发。

请注意，除非您为每个计划的事件传递唯一值，否则将忽略使用相同操作挂钩将事件安排在现有事件 10 分钟内发生$args。

使用wp_next_scheduled() 来防止重复事件。

使用wp_schedule_event() 安排重复事件。

参数

$timestamp整数必需的

下次运行事件的 Unix 时间戳 (UTC)。$hook细绳必需的

事件运行时要执行的操作挂钩。$args大批选修的

包含要传递给挂钩回调函数的参数的数组。数组中的每个值都作为单独的参数传递给回调。
数组键被忽略。

默认：array()$wp_error布尔值选修的

失败时是否返回WP_Error 。

默认：false

返回值

布尔| WP_Error如果事件已成功安排，则为 True。失败时返回False 或WP_Error 。

简单使用

添加一个一小时后执行的事件

function do_this_in_an_hour() {

    // 一小时后执行的内容
}
add_action( 'my_new_event','do_this_in_an_hour' );

wp_schedule_single_event( time() + 3600, 'my_new_event' );