无需访客触发、无需客户配置服务器cron：WordPress插件定时任务实现方案咨询

Great question—this is a common pain point with WordPress's default wp-cron, since it's indeed tied to visitor traffic. Let's break down practical, user-friendly solutions that let you run hourly tasks automatically, with no manual cron setup required from your plugin users.

1. 自动配置服务器级Cron（最优方案） #

The most reliable way to bypass wp-cron's visitor dependency is to set up a real server cron job that triggers your plugin's task directly. The trick is to make your plugin automatically attempt this setup on activation, so users don't have to lift a finger.

代码实现 #

First, hook into plugin activation/deactivation to manage the cron job:

// 插件激活时尝试添加服务器cron
register_activation_hook(__FILE__, 'my_plugin_setup_server_cron');
// 插件停用时移除服务器cron
register_deactivation_hook(__FILE__, 'my_plugin_remove_server_cron');

function my_plugin_setup_server_cron() {
    // 获取PHP可执行文件路径（兼容大多数服务器）
    $php_path = exec('which php') ?: '/usr/bin/php';
    if (empty($php_path)) {
        // 如果无法获取PHP路径，跳过并触发fallback提示
        add_option('my_plugin_cron_setup_failed', true);
        return;
    }

    // 生成安全的任务触发URL（带nonce防止恶意调用）
    $nonce = wp_create_nonce('my_hourly_task_nonce');
    $task_url = site_url("wp-cron.php?action=my_plugin_hourly_task&nonce={$nonce}");
    // 构建cron命令：每小时用curl访问触发URL
    $cron_command = "curl -s '{$task_url}' > /dev/null 2>&1";

    // 检查当前crontab是否已存在该任务
    $current_crontab = shell_exec('crontab -l') ?: '';
    if (strpos($current_crontab, $cron_command) === false) {
        // 将新任务添加到crontab
        $new_crontab = trim($current_crontab) . "\n* */1 * * * {$cron_command}\n";
        $tmp_file = tempnam(sys_get_temp_dir(), 'my_plugin_crontab');
        file_put_contents($tmp_file, $new_crontab);
        // 应用新的crontab
        shell_exec("crontab {$tmp_file}");
        unlink($tmp_file);
    }
}

function my_plugin_remove_server_cron() {
    $nonce = wp_create_nonce('my_hourly_task_nonce');
    $task_url = site_url("wp-cron.php?action=my_plugin_hourly_task&nonce={$nonce}");
    $cron_command = "curl -s '{$task_url}' > /dev/null 2>&1";

    // 从crontab中移除任务
    $current_crontab = shell_exec('crontab -l') ?: '';
    $new_crontab = preg_replace("/\n\* \*\/1 \* \* \* {$cron_command}\n/", "\n", $current_crontab);
    $tmp_file = tempnam(sys_get_temp_dir(), 'my_plugin_crontab');
    file_put_contents($tmp_file, $new_crontab);
    shell_exec("crontab {$tmp_file}");
    unlink($tmp_file);

    delete_option('my_plugin_cron_setup_failed');
}

Next, register your custom hourly task and verify the nonce for security:

// 注册定时任务钩子
add_action('my_plugin_hourly_task', 'my_plugin_run_hourly_logic');

// 验证请求并执行任务
add_action('wp_loaded', function() {
    if (isset($_GET['action']) && $_GET['action'] === 'my_plugin_hourly_task') {
        // 验证nonce防止恶意触发
        if (!isset($_GET['nonce']) || !wp_verify_nonce($_GET['nonce'], 'my_hourly_task_nonce')) {
            wp_die('Invalid request');
        }
        // 执行你的每小时任务
        my_plugin_run_hourly_logic();
        exit;
    }
});

function my_plugin_run_hourly_logic() {
    // 这里写你需要每小时运行的代码
    error_log('My plugin hourly task executed successfully');
    // 示例：更新插件数据、发送通知等
}

优缺点 #

• ✅ Pros: Fully automated for users with server exec access; runs reliably even with zero site traffic.
• ❌ Cons: Won't work on shared hosts that disable exec/shell_exec; requires web server user to have crontab permissions.

2. Fallback：检测WP-Cron状态并提示用户 #

If server cron auto-setup fails (e.g., exec is disabled), add a fallback to alert users and guide them to a simple fix. This ensures your plugin still works without forcing manual cron setup.

代码实现 #

// 后台提示用户WP-Cron未正常运行
add_action('admin_notices', 'my_plugin_cron_fallback_notice');

function my_plugin_cron_fallback_notice() {
    if (!get_option('my_plugin_cron_setup_failed')) {
        return;
    }

    $cron_url = site_url('wp-cron.php');
    echo '<div class="notice notice-warning is-dismissible">
            <p>你的插件定时任务需要外部触发才能正常运行。请在你的服务器cron中添加以下命令（每小时运行一次）：</p>
            <code>curl -s ' . esc_attr($cron_url) . ' > /dev/null 2>&1</code>
          </div>';
}

3. 第三方定时服务（备选） #

For users who can't set up server cron, you can integrate with free HTTP定时服务. Your plugin can auto-register a task with such a service on activation, but note that many require API keys, which may need user input. A simpler approach is to detect if wp-cron hasn't run in over an hour and prompt users to use a free service to hit your wp-cron.php URL hourly.

关键注意事项 #

• Always add nonce verification to your custom task endpoints to prevent abuse.
• Test your plugin on different hosting environments (shared, VPS, cPanel/Plesk) to handle edge cases like different PHP paths.

内容的提问来源于stack exchange，提问作者NSsem