分析 WordPress `wp_cron()` 机制的源码：如何通过页面请求模拟定时任务，并解释其潜在问题。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位技术大佬，晚上好！我是今晚的主讲人，很高兴能和大家一起探讨 WordPress 的 wp_cron() 机制。咱们今天的主题是：“伪”定时任务：WordPress wp_cron() 深度剖析与问题应对。

别被“伪”这个词吓到，wp_cron() 确实不是一个真正意义上的系统级定时任务，但它在 WordPress 的世界里却扮演着至关重要的角色。让我们一起揭开它神秘的面纱，看看它是如何运作的，又有哪些坑需要我们注意。

一、wp_cron() 机制：一个“请求驱动”的定时器

想象一下，你是一个勤劳的园丁，但你没有闹钟，只能靠别人来提醒你浇花。wp_cron() 就扮演着类似的角色。它本身并不会主动地执行任务，而是依赖于用户的页面请求来触发。

1. 核心原理：

wp_cron() 的核心思想是，当有用户访问你的 WordPress 站点时，它会检查是否有需要执行的定时任务。如果有，就执行这些任务。如果没有，就什么也不做。

2. 源码剖析：wp-cron.php

wp_cron() 的主要逻辑都集中在 wp-cron.php 文件中。我们先来简单浏览一下它的代码结构：

<?php
// 确保 WordPress 已加载
if ( ! defined( 'ABSPATH' ) ) {
    define( 'WP_USE_THEMES', false );
    require_once( dirname( __FILE__ ) . '/wp-load.php' );
}

// 忽略用户中止连接
ignore_user_abort( true );

// 设置超时时间
if ( ! defined( 'DOING_CRON' ) ) {
    define( 'DOING_CRON', true );
}

// 加载 WordPress 函数
require_once( ABSPATH . 'wp-includes/cron.php' );

// 检查密钥是否匹配 (可选)
if ( isset( $_GET['doing_wp_cron'] ) ) {
    $cron_key = $_GET['doing_wp_cron'];
    if ( ! wp_verify_nonce( $cron_key, 'wp_cron' ) ) { // 验证nonce
        die();
    }
}

// 运行 cron
spawn_cron();

// 退出
exit();

这段代码做了几件事：

确保 WordPress 已加载： 检查 ABSPATH 是否定义，如果没定义，就加载 wp-load.php，这是 WordPress 的核心加载文件。
DOING_CRON 常量： 定义 DOING_CRON 常量，告诉 WordPress 当前正在执行 cron 任务，避免某些插件或主题的冲突。
cron.php 加载： 加载 wp-includes/cron.php 文件，这里包含了 wp_cron() 的核心函数。
Nonce 验证（可选）： 如果 URL 中包含 doing_wp_cron 参数，会验证 nonce 值，防止恶意触发。 Nonce 是一个一次性的、随机的字符串，用于防止 CSRF 攻击。
spawn_cron() 函数： 调用 spawn_cron() 函数，这是启动 cron 任务的关键。

3. 核心函数：spawn_cron()

spawn_cron() 函数负责实际触发 cron 任务的执行。它的源码如下：

function spawn_cron( $async_spawn = false ) {
    if ( defined( 'DISABLE_WP_CRON' ) && DISABLE_WP_CRON ) {
        return false;
    }

    $cron_url = site_url( 'wp-cron.php' );

    $key = wp_create_nonce( 'wp_cron' );
    $cron_url = add_query_arg( 'doing_wp_cron', $key, $cron_url );

    if ( $async_spawn ) {
        wp_remote_post( $cron_url, array(
            'timeout'   => 0.01,
            'blocking'  => false,
            'sslverify' => apply_filters( 'https_local_ssl_verify', false )
        ) );
    } else {
        wp_remote_get( $cron_url, array(
            'timeout'   => 60,
            'blocking'  => true,
            'sslverify' => apply_filters( 'https_local_ssl_verify', false )
        ) );
    }

    return true;
}

这个函数做了以下事情：

检查 DISABLE_WP_CRON： 如果 DISABLE_WP_CRON 常量被定义为 true，则禁用 wp_cron()。
构建 wp-cron.php URL： 创建 wp-cron.php 的 URL，并添加一个 doing_wp_cron 参数，这个参数的值是一个 nonce。
异步或同步执行： 根据 $async_spawn 参数，选择异步或同步执行 wp-cron.php。
- 异步执行 ($async_spawn = true)： 使用 wp_remote_post() 函数，设置 timeout 为 0.01 秒，blocking 为 false，这意味着 WordPress 会发送一个 HTTP 请求到 wp-cron.php，但不会等待响应。这是一种非阻塞的调用方式，可以避免阻塞用户的页面请求。
- 同步执行 ($async_spawn = false)： 使用 wp_remote_get() 函数，设置 timeout 为 60 秒，blocking 为 true，这意味着 WordPress 会发送一个 HTTP 请求到 wp-cron.php，并等待响应。这是一种阻塞的调用方式，可能会影响用户的页面加载速度。

4. Cron 事件的管理：wp_schedule_event(), wp_unschedule_event() and wp_next_scheduled()

WordPress 提供了几个函数来管理 cron 事件：

wp_schedule_event( $timestamp, $recurrence, $hook, $args = array() )： 用于计划一个 cron 事件。
- $timestamp：事件执行的时间戳。
- $recurrence：事件重复的频率，可以是 'hourly'、'daily'、'weekly' 等。
- $hook：事件触发时要执行的 action hook。
- $args：传递给 action hook 的参数。
wp_unschedule_event( $timestamp, $hook, $args = array() )： 用于取消一个 cron 事件。
- $timestamp：事件执行的时间戳。
- $hook：事件触发时要执行的 action hook。
- $args：传递给 action hook 的参数。
wp_next_scheduled( $hook, $args = array() )： 用于获取下一个计划执行的 cron 事件的时间戳。
- $hook：事件触发时要执行的 action hook。
- $args：传递给 action hook 的参数。

5. 一个简单的例子：定期清理垃圾评论

// 定义一个函数来清理垃圾评论
function my_delete_spam_comments() {
    global $wpdb;
    $wpdb->query( "DELETE FROM $wpdb->comments WHERE comment_approved = 'spam'" );
}

// 计划一个每天执行的 cron 事件
if ( ! wp_next_scheduled( 'my_delete_spam_comments_event' ) ) {
    wp_schedule_event( time(), 'daily', 'my_delete_spam_comments_event' );
}

// 将函数绑定到 action hook
add_action( 'my_delete_spam_comments_event', 'my_delete_spam_comments' );

这段代码做了以下事情：

定义 my_delete_spam_comments() 函数： 这个函数负责实际清理垃圾评论。
计划 cron 事件： 使用 wp_schedule_event() 函数，计划一个每天执行的 cron 事件，这个事件会触发 my_delete_spam_comments_event action hook。
绑定 action hook： 使用 add_action() 函数，将 my_delete_spam_comments() 函数绑定到 my_delete_spam_comments_event action hook。

二、wp_cron() 的潜在问题：

虽然 wp_cron() 使用起来很方便，但它也存在一些潜在的问题：

问题	描述	解决方案
依赖页面请求	`wp_cron()` 依赖于用户的页面请求来触发，这意味着如果你的网站流量很低，定时任务可能不会按时执行。	使用外部 Cron：使用服务器的 Cron 作业，定期访问 `wp-cron.php`。这是最可靠的解决方案。 WP Crontrol 插件：使用 WP Crontrol 插件来管理和监控 `wp_cron()` 事件。它可以让你查看所有计划的事件，并手动运行它们。
执行时间不确定	由于 `wp_cron()` 是在页面请求时触发的，所以任务的执行时间是不确定的。例如，你计划一个每天凌晨 2 点执行的任务，但如果凌晨 2 点没有用户访问你的网站，这个任务就不会执行，直到有用户访问你的网站。	同上
性能问题	如果你的网站流量很大，每次页面请求都会触发 `wp_cron()`，这可能会导致性能问题。特别是当你的定时任务很耗时时，它会阻塞用户的页面请求，导致页面加载速度变慢。	禁用 `wp_cron()`：使用 `define('DISABLE_WP_CRON', true);` 在 `wp-config.php` 文件中禁用 `wp_cron()`。然后使用外部 Cron 来触发 `wp-cron.php`。优化定时任务：优化你的定时任务，减少它们的执行时间。例如，可以使用批量处理来减少数据库查询次数。
任务重叠	如果你的定时任务执行时间很长，并且执行频率很高，可能会导致任务重叠。例如，你计划一个每 5 分钟执行一次的任务，但如果这个任务的执行时间超过 5 分钟，那么下一个任务就会在上一个任务完成之前开始执行，这可能会导致数据不一致或其他问题。	使用锁机制：在你的定时任务中使用锁机制，防止任务重叠。例如，可以使用 WordPress 的 `transient` API 来创建一个锁。在任务开始执行时，设置一个 transient，表示任务正在执行。在任务完成时，删除这个 transient。在任务开始执行之前，检查这个 transient 是否存在，如果存在，则表示任务正在执行，不要重复执行。延长执行频率：延长你的定时任务的执行频率，避免任务重叠。
与缓存插件冲突	某些缓存插件可能会缓存 `wp-cron.php` 的响应，导致定时任务无法正常执行。	排除 `wp-cron.php`：在你的缓存插件中排除 `wp-cron.php`，不要缓存它的响应。使用 Transients API: 使用 WordPress 的 Transients API来存储计划的事件，而不是直接依赖数据库。这样可以避免与缓存插件的冲突。
在某些主机环境无法正常运行	一些主机环境可能会限制对 `wp-cron.php` 的访问，或者禁用 `wp_remote_get()` 和 `wp_remote_post()` 函数，导致 `wp_cron()` 无法正常运行。	联系主机提供商：联系你的主机提供商，询问他们是否限制了对 `wp-cron.php` 的访问，或者禁用了 `wp_remote_get()` 和 `wp_remote_post()` 函数。如果他们限制了这些功能，你可以要求他们解除限制，或者更换主机。使用备用方案：如果无法使用 `wp_remote_get()` 和 `wp_remote_post()` 函数，可以使用 `curl` 函数来发送 HTTP 请求。

三、替代方案：外部 Cron 和 WP Crontrol 插件

鉴于 wp_cron() 存在诸多问题，我们通常会选择更可靠的替代方案。

1. 外部 Cron (System Cron)

这是最推荐的解决方案。它利用服务器自身的定时任务机制，定期访问 wp-cron.php，从而触发 WordPress 的定时任务。

优点：
- 更可靠： 不依赖页面请求，可以保证定时任务按时执行。
- 性能更好： 不会在页面请求时触发 cron 任务，避免阻塞用户的页面请求。
缺点：
- 需要服务器权限： 需要你有服务器的 SSH 权限，才能设置 Cron 作业。
- 配置稍微复杂： 需要手动配置 Cron 作业。
配置方法：
1. 登录服务器： 使用 SSH 登录你的服务器。
2. 编辑 Cron 作业： 运行 crontab -e 命令来编辑 Cron 作业。
3. 添加 Cron 作业： 添加一行类似下面的代码：
```
*/5 * * * * wget -q -O /dev/null https://your-domain.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1
```
  这表示每 5 分钟访问一次 wp-cron.php。你需要将 https://your-domain.com 替换为你的网站域名。 >/dev/null 2>&1 用于丢弃输出和错误信息。
  
  或者，你也可以使用 curl 命令：
```
*/5 * * * * curl -q -O /dev/null https://your-domain.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1
```
4. 保存 Cron 作业： 保存并退出编辑器。

2. WP Crontrol 插件

WP Crontrol 插件提供了一个友好的界面，用于管理和监控 wp_cron() 事件。

优点：
- 界面友好： 提供了一个直观的界面，可以查看、编辑和删除 cron 事件。
- 手动运行： 可以手动运行 cron 事件，方便调试。
- 监控： 可以监控 cron 事件的执行情况，查看是否有错误发生。
缺点：
- 仍然依赖 wp_cron()： 本质上还是依赖 wp_cron() 机制，如果 wp_cron() 本身有问题，插件也无法解决。
- 不能完全替代外部 Cron： 虽然可以手动运行 cron 事件，但不能保证定时任务按时执行。

四、总结

wp_cron() 是 WordPress 的一个方便的定时任务机制，但它存在一些潜在的问题，比如依赖页面请求、执行时间不确定、性能问题等。为了保证定时任务的可靠性，建议使用外部 Cron 或 WP Crontrol 插件。

方案	优点	缺点	适用场景
`wp_cron()`	使用简单，无需额外配置。适用于简单的定时任务。	依赖页面请求，执行时间不确定。可能存在性能问题。	小型网站，流量较低。对定时任务的执行时间要求不高。
外部 Cron	更可靠，不依赖页面请求。性能更好，不会阻塞用户的页面请求。	需要服务器权限。配置稍微复杂。	大型网站，流量较高。对定时任务的执行时间要求较高。* 需要保证定时任务按时执行。
WP Crontrol 插件	界面友好，易于使用。可以手动运行 cron 事件，方便调试。* 可以监控 cron 事件的执行情况。	仍然依赖 `wp_cron()`。不能完全替代外部 Cron。	需要管理和监控 `wp_cron()` 事件。需要手动运行 cron 事件。* 需要查看 cron 事件的执行情况。

希望今天的分享能帮助大家更深入地了解 WordPress 的 wp_cron() 机制，并选择最适合自己的定时任务解决方案。谢谢大家！

最后，记住一句至理名言：“代码虐我千百遍，我待代码如初恋！” 祝大家编程愉快！

发表回复 取消回复

发表回复取消回复