WordPress源码深度解析之：`WordPress`的`Cron`：如何手动触发`Cron`任务。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

嘿，各位技术控们！今天咱们来聊聊WordPress后台那些默默干活的小精灵——Cron任务。别以为Cron只有服务器那边才有，WordPress也有自己的Cron系统，虽然它“伪”了点，但关键时刻还是能派上大用场的。咱们今天要做的就是，彻底摸清WordPress Cron的底细，并且学会手动触发它，让那些懒洋洋的任务赶紧动起来！

第一部分：WordPress Cron的前世今生

啥是Cron？简单来说，它就是一个计划任务管理器，可以让你按照设定的时间执行一些脚本。比如，定时发布文章、清理垃圾评论、发送邮件等等。

但是，WordPress的Cron并不是真正的系统Cron。它其实是一个“伪Cron”，或者说是一个“事件调度器”。它的原理是：当有人访问你的WordPress站点时，它会检查是否有到期的Cron事件需要执行。如果有，它就会执行这些事件。

所以，如果你的网站访问量很低，那么你的Cron任务可能就不会按时执行。这就是为什么有时候你会发现，定时发布的文章延迟了，或者自动备份插件没有按时工作。

那么，WordPress Cron到底有什么特点呢？

特点	说明
依赖访问量	只有当有人访问你的网站时，WordPress才会检查并执行Cron任务。
易于使用	WordPress提供了一系列的函数，可以让你很方便地添加、修改和删除Cron任务。
兼容性好	WordPress Cron与大多数插件和主题兼容，你可以放心地使用它来执行各种任务。
可能不准确	由于依赖访问量，WordPress Cron的执行时间可能不太准确。
性能影响	如果你的Cron任务很多，或者任务执行时间很长，可能会对网站的性能产生一定的影响。

第二部分：WordPress Cron的核心函数

想要玩转WordPress Cron，首先要熟悉几个核心函数：

wp_schedule_event()：用于添加一个Cron事件。
wp_schedule_single_event()：用于添加一个只执行一次的Cron事件。
wp_unschedule_event()：用于移除一个Cron事件。
wp_next_scheduled()：用于获取下一个Cron事件的执行时间。
wp_clear_scheduled_hook()：用于清除指定hook的所有定时事件。
do_action()：这个函数实际上不是 Cron 专用的，但是它被用来触发 Cron 事件，所以也需要了解。
add_action()：同样，这个函数也不是 Cron 专用的，但是它被用来定义 Cron 事件触发时要执行的函数。

咱们一个个来详细看看：

wp_schedule_event()

这个函数是添加Cron事件的利器。它的原型是：
```
wp_schedule_event( int $timestamp, string $recurrence, string $hook, array $args = array() )
```
- $timestamp：事件的执行时间戳（Unix时间戳）。
- $recurrence：事件的重复频率，可以是hourly（每小时）、daily（每天）、weekly（每周）等等，也可以是自定义的频率。
- $hook：事件触发时要执行的动作（Action Hook）。
- $args：传递给动作函数的参数（可选）。
举个例子，假设我们要每天凌晨3点执行一个名为my_daily_task的动作：
```
$timestamp = strtotime( '3:00am' ); // 获取凌晨3点的时间戳
wp_schedule_event( $timestamp, 'daily', 'my_daily_task' );
```
然后，我们需要定义my_daily_task这个动作：
```
add_action( 'my_daily_task', 'my_daily_task_function' );
function my_daily_task_function() {
    // 这里写你的任务代码，比如清理垃圾评论、发送邮件等等
    // 比如：
    wp_delete_comment( 123, true ); // 删除ID为123的评论，并且彻底删除
}
```

wp_schedule_single_event()

这个函数用于添加一个只执行一次的Cron事件。它的原型是：

wp_schedule_single_event( int $timestamp, string $hook, array $args = array() )

参数和wp_schedule_event()类似，只是没有$recurrence参数，因为它只执行一次。

比如，我们要在一个小时后执行一个名为my_one_time_task的动作：

$timestamp = time() + 3600; // 获取一个小时后的时间戳
wp_schedule_single_event( $timestamp, 'my_one_time_task' );

然后，定义my_one_time_task动作：

add_action( 'my_one_time_task', 'my_one_time_task_function' );
function my_one_time_task_function() {
    // 这里写你的任务代码
    // 比如：
    wp_mail( '[email protected]', '一次性任务完成', '任务已经成功执行！' );
}

wp_unschedule_event()

这个函数用于移除一个Cron事件。它的原型是：
```
wp_unschedule_event( int $timestamp, string $hook, array $args = array() )
```
参数和wp_schedule_event()完全一样，需要提供相同的$timestamp、$hook和$args才能正确移除事件。

比如，我们要移除之前添加的my_daily_task事件：
```
$timestamp = strtotime( '3:00am' );
wp_unschedule_event( $timestamp, 'my_daily_task' );
```

wp_next_scheduled()

这个函数用于获取下一个Cron事件的执行时间。它的原型是：

wp_next_scheduled( string $hook, array $args = array() )

$hook：要查询的动作名称。
$args：传递给动作函数的参数（可选）。

比如，我们要获取my_daily_task事件的下一个执行时间：

$next_execution = wp_next_scheduled( 'my_daily_task' );
if ( $next_execution ) {
    echo '下一个执行时间：' . date( 'Y-m-d H:i:s', $next_execution );
} else {
    echo '没有找到该事件';
}

wp_clear_scheduled_hook()

这个函数用于清除指定hook的所有定时事件。这比 wp_unschedule_event() 更暴力，因为它会删除所有与特定 hook 关联的定时事件，而不需要指定时间戳和参数。
```
wp_clear_scheduled_hook( string $hook );
```
例如，我们要清除所有与 my_daily_task 关联的定时事件：
```
wp_clear_scheduled_hook( 'my_daily_task' );
```

第三部分：手动触发WordPress Cron

好了，现在我们已经了解了WordPress Cron的基本原理和核心函数。接下来，我们要学习如何手动触发Cron任务。

为什么要手动触发呢？就像前面说的，WordPress Cron依赖访问量，如果你的网站访问量很低，或者你想立即执行某个Cron任务，手动触发就显得非常必要了。

方法一：通过访问wp-cron.php

WordPress Cron的核心脚本是wp-cron.php。我们可以通过直接访问这个文件来触发Cron任务。

找到你的wp-cron.php文件： 它通常位于WordPress根目录下。
在浏览器中输入URL： http://你的域名/wp-cron.php

访问这个URL后，WordPress会检查是否有到期的Cron事件需要执行，如果有，就会执行它们。

注意： 这种方法可能会受到服务器的限制，有些服务器可能会禁止直接访问wp-cron.php。

方法二：使用WP-CLI

如果你熟悉WP-CLI（WordPress命令行工具），可以使用它来手动触发Cron任务。

安装WP-CLI： 如果你还没有安装WP-CLI，请先安装它。具体安装方法可以参考WP-CLI的官方文档。
使用wp cron event run命令：
```
wp cron event run <hook> [--due-now] [--url=<url>]
```
- <hook>：要执行的动作名称。
- --due-now：强制执行，即使事件没有到期。
- --url=<url>：指定WordPress站点的URL（可选）。
比如，我们要强制执行my_daily_task事件：
```
wp cron event run my_daily_task --due-now
```

方法三：使用插件

还有一些插件可以帮助你手动触发WordPress Cron任务。比如，WP Crontrol插件。

安装并激活WP Crontrol插件。
进入工具 -> Cron Events页面。
找到你要执行的Cron事件，点击Run now按钮。

这个插件还可以让你查看所有已注册的Cron事件，以及它们的执行时间和参数。

方法四：使用代码手动触发（不推荐，除非你知道自己在做什么）

你可以使用 do_action() 函数在代码中手动触发 Cron 事件。但是，这种方法通常不推荐，除非你非常清楚自己在做什么，并且知道这样做可能带来的潜在风险。因为直接调用 do_action() 会绕过 WordPress 的 Cron 调度系统，可能会导致任务被多次执行，或者在不应该执行的时候执行。

// 手动触发 my_daily_task 事件
do_action( 'my_daily_task' );

第四部分：自定义Cron时间间隔

WordPress默认提供了一些Cron时间间隔，比如hourly、daily、weekly等等。但是，有时候我们需要自定义Cron时间间隔。比如，每15分钟执行一次任务。

要自定义Cron时间间隔，我们需要使用cron_schedules过滤器。

add_filter( 'cron_schedules', 'my_custom_cron_schedules' );
function my_custom_cron_schedules( $schedules ) {
    $schedules['every_fifteen_minutes'] = array(
        'interval' => 900, // 900秒 = 15分钟
        'display'  => __( 'Every 15 Minutes' )
    );
    return $schedules;
}

这段代码添加了一个名为every_fifteen_minutes的Cron时间间隔，它的间隔时间是900秒（15分钟）。

然后，我们就可以使用这个自定义的时间间隔来添加Cron事件了：

$timestamp = time(); // 获取当前时间戳
wp_schedule_event( $timestamp, 'every_fifteen_minutes', 'my_fifteen_minute_task' );

add_action( 'my_fifteen_minute_task', 'my_fifteen_minute_task_function' );
function my_fifteen_minute_task_function() {
    // 这里写你的任务代码
    // 比如：
    error_log( '每15分钟执行一次的任务！' ); // 记录日志
}

第五部分：排查Cron问题

WordPress Cron虽然方便，但有时候也会出现问题。比如，Cron任务没有按时执行，或者执行失败。

遇到Cron问题，我们可以尝试以下方法来排查：

检查Cron事件是否正确添加： 使用WP Crontrol插件或者wp cron event list命令来查看所有已注册的Cron事件，确认你要执行的事件是否在列表中，以及它的执行时间和参数是否正确。
检查Cron事件是否被禁用： 有些插件可能会禁用WordPress Cron。检查你的插件设置，看看是否有禁用Cron的选项。
检查服务器是否支持Cron： 有些服务器可能会禁止直接访问wp-cron.php，或者限制Cron任务的执行。联系你的服务器提供商，确认服务器是否支持Cron。
查看错误日志： 如果Cron任务执行失败，可能会在错误日志中留下记录。查看你的WordPress错误日志，看看是否有相关的错误信息。
手动触发Cron任务： 使用前面介绍的方法手动触发Cron任务，看看是否能够正常执行。如果手动触发可以正常执行，说明Cron事件本身没有问题，可能是自动触发机制有问题。

案例分析：解决定时文章发布失败的问题

假设你发现你的定时文章没有按时发布。我们可以按照以下步骤来排查：

检查文章的发布时间是否正确： 确认文章的发布时间是否设置在未来，并且时间格式是否正确。
检查wp-cron.php是否可以访问： 在浏览器中输入http://你的域名/wp-cron.php，看看是否能够正常访问。如果无法访问，可能是服务器禁止了直接访问wp-cron.php。
使用WP Crontrol插件查看publish_future_post事件： 这个事件负责发布定时文章。检查这个事件是否在列表中，以及它的执行时间是否正确。
手动触发publish_future_post事件： 使用WP Crontrol插件或者wp cron event run publish_future_post --due-now命令来手动触发publish_future_post事件，看看是否能够发布文章。
如果以上方法都无效，尝试禁用所有插件，然后逐个激活，看看是否是某个插件导致了Cron问题。

总结

WordPress Cron是一个非常实用的工具，可以帮助我们自动化执行各种任务。掌握WordPress Cron的原理和使用方法，可以让我们更好地管理和维护WordPress站点。希望今天的分享能够帮助大家更好地理解和使用WordPress Cron。记住，手动触发是解决问题的关键！

下次有机会，咱们再聊聊如何用代码优化WordPress，让你的网站飞起来！祝大家编码愉快！

发表回复 取消回复

发表回复取消回复