WordPress源码深度解析之：`WordPress`的`Cron`系统：`wp-cron.php`的异步任务调度与实现缺陷。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

WordPress Cron：定时炸弹还是贴心管家？

各位观众，晚上好！我是你们的老朋友，今天咱们来聊聊WordPress这个老朋友身上一个既让人爱又让人恨的家伙：WordPress Cron。

等等，先别急着翻白眼，我知道你们很多人对wp-cron.php意见很大。什么？你说它是伪Cron？执行效率低？影响网站性能？嗯，这些我都知道，今天我们就来好好扒一扒它的皮，看看它到底是个定时炸弹还是个贴心管家，以及它为什么会变成现在这个样子，还有我们怎么才能更好地使用它。

什么是WordPress Cron？

首先，咱们得明确一点，这里的Cron，可不是Linux系统里那个真正的Cron。WordPress Cron，说白了，就是一个模拟的定时任务调度系统。它允许你设置一些任务，让WordPress在特定的时间自动执行。比如说，自动发布文章、定时备份数据库、清理垃圾评论等等。

`wp-cron.php`：背后的英雄与罪魁祸首

所有这些定时任务，都得靠wp-cron.php这个文件来触发。它的工作原理是这样的：

用户访问网站： 当有用户访问你的WordPress网站时，WordPress会检查是否有需要执行的定时任务。
触发wp-cron.php： 如果有，WordPress就会尝试执行wp-cron.php。
执行任务： wp-cron.php会读取WordPress数据库中存储的定时任务信息，并执行那些到期的任务。

听起来很美好对不对？但问题就出在这个触发机制上。

为什么说它是“伪Cron”？

因为它的执行完全依赖于用户的访问。如果你的网站访问量很小，那么wp-cron.php可能很久都不会被触发，导致你的定时任务无法按时执行。

这就是为什么很多人说它是“伪Cron”的原因，因为它不像Linux Cron那样，由操作系统内核直接驱动，而是依赖于HTTP请求。

代码剖析：`wp-cron.php`的庐山真面目

我们来简单看看wp-cron.php的代码片段，了解一下它的工作原理：

<?php

// 定义DOING_CRON常量，防止重复执行
if ( defined('DOING_CRON') && DOING_CRON ) {
    return;
}
define('DOING_CRON', true);

// ... 一些检查和初始化代码 ...

// 包含wp-load.php，加载WordPress核心文件
if ( ! defined('ABSPATH') ) {
    /** Sets up the WordPress Environment. */
    require_once( dirname( __FILE__ ) . '/wp-load.php' );
}

// 检查是否超过最大执行时间
if ( ini_get( 'max_execution_time' ) < 30 ) {
    @ini_set( 'max_execution_time', 300 );
}

// 获取锁，防止并发执行
$cron_lock = 'cron_lock';
$lock_expiration = 120; // 锁过期时间，单位秒
$lock = get_transient( $cron_lock );

if ( $lock ) {
    wp_die(
        /* translators: %s: Time in seconds */
        sprintf( __( 'Another process is currently running. Please try again in %s seconds.' ), (int) ( $lock_expiration - ( time() - $lock ) ) )
    );
}

set_transient( $cron_lock, time(), $lock_expiration );

// 运行Cron
spawn_cron();

// 释放锁
delete_transient( $cron_lock );

// 退出
exit();

这段代码的核心逻辑就是：

防止并发执行： 通过设置一个transient（临时选项）来加锁，避免多个wp-cron.php实例同时运行。
运行Cron： 调用spawn_cron()函数来执行定时任务。

关键在于spawn_cron()函数，它实际上只是异步地发起一个HTTP请求，再次访问wp-cron.php，让它在后台执行任务。

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

    $cron_url = add_query_arg( 'doing_wp_cron', wp_rand(), site_url( 'wp-cron.php' ) );

    if ( $async_spawn ) {
        // 使用非阻塞方式发起HTTP请求
        wp_remote_post( $cron_url, array(
            'blocking'   => false,
            'timeout'    => 0.01,
            'body'       => array( 'cron' => true )
        ) );
    } else {
        // 使用阻塞方式发起HTTP请求
        wp_remote_get( $cron_url, array( 'timeout' => 60 ) );
    }
}

可以看到，spawn_cron()函数使用wp_remote_post()或wp_remote_get()函数发起HTTP请求来执行wp-cron.php。默认情况下，WordPress会使用阻塞方式发起请求，也就是说，用户需要等待wp-cron.php执行完毕才能看到页面。如果任务很多，或者服务器性能不好，就会导致页面加载缓慢。

WordPress Cron 的缺点总结：

为了更清晰的说明问题，用表格来总结一下：

缺点	描述	影响
依赖用户访问	`wp-cron.php`的执行依赖于用户访问网站，低流量网站的定时任务可能无法按时执行。	定时任务执行不及时，影响网站功能。
阻塞请求（默认）	默认情况下，`spawn_cron()`函数使用阻塞方式发起HTTP请求，用户需要等待`wp-cron.php`执行完毕才能看到页面。	页面加载缓慢，用户体验差。
并发执行问题	虽然有锁机制，但在某些情况下（例如服务器时间不同步），仍然可能出现并发执行的情况。	数据不一致，任务执行错误。
资源消耗	每次用户访问网站都可能触发`wp-cron.php`的执行，频繁的HTTP请求会消耗服务器资源。	服务器负载升高，网站性能下降。
执行时间限制	受限于PHP的`max_execution_time`配置，如果定时任务执行时间过长，可能会被中断。	定时任务执行不完整。
错误处理不足	`wp-cron.php`的错误处理机制比较简单，如果定时任务执行出错，可能不会有详细的错误信息。	难以排查问题。

如何优化WordPress Cron？

既然wp-cron.php有这么多缺点，那么我们该如何优化它呢？

禁用wp-cron.php： 如果你的网站访问量很小，或者你对定时任务的执行时间要求很高，那么最好的方法就是禁用wp-cron.php，转而使用真正的系统Cron。

你可以在wp-config.php文件中添加以下代码来禁用wp-cron.php：
```
define('DISABLE_WP_CRON', true);
```
配置系统Cron： 禁用wp-cron.php后，你需要配置系统Cron来定期访问wp-cron.php。你可以通过服务器的管理面板（如cPanel、Plesk）或者通过SSH命令行来配置。

一个典型的Cron命令如下：
```
*/5 * * * * wget -q -O /dev/null https://your-website.com/wp-cron.php?doing_wp_cron
```
这条命令表示每5分钟访问一次wp-cron.php。

注意： 将https://your-website.com替换成你自己的网站地址。
使用非阻塞方式发起HTTP请求： 如果你不想禁用wp-cron.php，但又希望提高网站性能，那么可以尝试使用非阻塞方式发起HTTP请求。

你可以通过修改wp-config.php文件来开启异步Cron：
```
define('ALTERNATE_WP_CRON', true);
```
开启ALTERNATE_WP_CRON后，WordPress会尝试使用非阻塞方式发起HTTP请求。但是，这种方式并不一定适用于所有服务器环境，你需要测试一下是否有效。
优化定时任务： 尽量减少定时任务的数量，并优化每个任务的执行效率。避免在定时任务中执行复杂的计算或者大量的数据库操作。
使用第三方插件： 有一些第三方插件可以帮助你更好地管理和优化WordPress Cron，例如WP Crontrol、Advanced Cron Manager等等。这些插件可以让你更方便地查看、编辑和删除定时任务，还可以监控Cron的执行情况。

代码示例：自定义Cron事件

除了使用WordPress自带的定时任务，你还可以自定义Cron事件来执行自己的代码。

首先，你需要使用wp_schedule_event()函数来注册一个Cron事件：

add_action( 'wp', 'my_schedule_event' );
function my_schedule_event() {
    if ( ! wp_next_scheduled( 'my_hourly_event' ) ) {
        wp_schedule_event( time(), 'hourly', 'my_hourly_event' );
    }
}

这段代码会在WordPress初始化时检查是否已经注册了my_hourly_event这个Cron事件。如果没有，就使用wp_schedule_event()函数来注册一个每小时执行一次的事件。

wp_schedule_event()函数的参数如下：

$timestamp：事件的起始时间戳。
$recurrence：事件的重复间隔，可以是hourly（每小时）、daily（每天）、weekly（每周）等等。
$hook：事件的回调函数名。

接下来，你需要使用add_action()函数来注册回调函数：

add_action( 'my_hourly_event', 'do_something_every_hour' );
function do_something_every_hour() {
    // 在这里执行你的代码
    // 例如，发送邮件、更新数据等等
    wp_mail( '[email protected]', 'Hourly Cron Event', 'This is a test email from the hourly cron event.' );
}

这段代码会在my_hourly_event事件被触发时，执行do_something_every_hour()函数。

WordPress Cron 事件调度频率参数说明

为了大家更加清晰的理解事件调度，我用表格来详细说明调度频率参数：

参数	描述	示例
`hourly`	每小时执行一次。	`wp_schedule_event( time(), 'hourly', 'my_event' );`
`twicedaily`	每天执行两次，分别在午夜和中午。	`wp_schedule_event( time(), 'twicedaily', 'my_event' );`
`daily`	每天执行一次，在午夜。	`wp_schedule_event( time(), 'daily', 'my_event' );`
`weekly`	每周执行一次，在每周一的午夜。	`wp_schedule_event( time(), 'weekly', 'my_event' );`
`monthly`	每月执行一次，在每月1号的午夜。	`wp_schedule_event( time(), 'monthly', 'my_event' );`
自定义	你也可以自定义Cron的执行间隔。首先，你需要使用`add_filter()`函数来添加一个新的Cron间隔：
	“`php
	add_filter( ‘cron_schedules’, ‘my_custom_cron_schedule’ );
	function my_custom_cron_schedule( $schedules ) {
	$schedules[‘every_five_minutes’] = array(
	‘interval’ => 300, // 单位：秒
	‘display’ => __( ‘Every Five Minutes’ )
	);
	return $schedules;
	}
	然后，你就可以使用这个自定义的Cron间隔来注册事件：
	“`php
	wp_schedule_event( time(), ‘every_five_minutes’, ‘my_event’ );

注意事项：

避免冲突： 在自定义Cron事件时，要避免与其他插件或主题的Cron事件发生冲突。最好使用独特的回调函数名和事件名。
错误处理： 在回调函数中，要做好错误处理，避免因为一个Cron事件出错而影响其他事件的执行。
测试： 在部署Cron事件之前，一定要先进行测试，确保它们能够正常工作。

总结：

WordPress Cron虽然有一些缺陷，但它仍然是一个非常有用的工具。通过合理的配置和优化，我们可以让它更好地为我们的网站服务。

记住，WordPress Cron不是万能的，它只是一个模拟的定时任务调度系统。如果你对定时任务的执行时间要求很高，或者你的网站访问量很小，那么最好还是使用真正的系统Cron。

好了，今天的讲座就到这里。希望大家能够对WordPress Cron有一个更深入的了解，并能够更好地利用它来管理和维护自己的网站。

感谢大家的收听！我们下次再见！