萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 定時任務實現方案全解析:從 Web 觸發到系統級排程

前言

在 PHP 開發中,定時任務(Cron Job)是處理定期數據清理、報表生成、郵件發送等後台任務的核心需求。不同於 Java 或 Go 等長駐內存的語言,PHP 傳統上運行於請求-響應模式,這使得定時任務的實現呈現出多樣化的技術路線。本文將系統梳理主流實現方案,並深度解析 ignore_user_abort() 這一常被忽視卻極具潛力的原生函數。

主流實現方案對比

1. Web 請求觸發模式(Discuz!、UChome、PHPWind 採用)

核心邏輯: 將任務元數據存入數據庫,每次用戶訪問頁面時,按順序檢查並執行一個到期任務。

  • 優點: 無需系統級權限,虛擬主機也能運行;實現簡單。
  • 缺點: 依賴流量觸發,低峰期任務延遲嚴重;高併發下可能重複執行或阻塞用戶請求;長耗時任務會拖慢頁面響應。

UChome 的實現位於 ./source/function_cron.php,典型代碼邏輯為:if ($task['nextrun'] < TIMESTAMP) { run_task($task); }。

2. 系統級 Crontab + CLI PHP(推薦生產環境)

* * * * * /usr/bin/php /var/www/html/cron.php >> /var/log/cron.log 2>&1
  • 優點: 精準到分鐘級,獨立於 Web 進程,不影響用戶體驗,支持長時間運行任務。
  • 缺點: 需要服務器 Shell 訪問權限;Windows 環境下需借助任務計劃程序。

3. Crontab + wget/cURL 觸發 Web 入口

*/5 * * * * wget -q -O /dev/null "https://example.com/cron/trigger"
  • 適用於無 CLI 權限的虛擬主機,但繼承 Web 模式的超時限制,需配合 set_time_limit(0) 和 ignore_user_abort(true)。

4. PHP 守護進程(Daemon Process)

nohup php daemon.php > /dev/null 2>&1 &

使用 while(true) { sleep($interval); run_tasks(); } 循環。關鍵點: 必須將業務邏輯與循環解耦,避免內存洩漏導致進程體積無限膨脹;建議引入 pcntl_fork 實現多進程並行處理。

5. 純 PHP 死循環 + ignore_user_abort()(本文重點)

利用 PHP 原生函數實現類 Linux Cron 的獨立後台運行,無需系統級排程工具。

深度解析:ignore_user_abort() 與 set_time_limit()

函數簽名與行為

int ignore_user_abort(bool $setting = null)
  • 作用: 設置客戶端斷開連接(關閉瀏覽器、點擊停止)時,腳本是否繼續執行。傳入 true 即啟用「後台運行」模式。
  • 返回值: 官方文檔稱返回布爾值,實測返回 int(0 或 1),表示修改前的設置狀態。

黃金搭檔:set_time_limit(0)

PHP 默認最大執行時間 30 秒(max_execution_time)。set_time_limit(0) 移除此限制,允許腳本無限期運行。注意: 在安全模式或某些虛擬主機下可能被禁用。

實戰代碼:純 PHP 實現的定時任務守護進程

<?php
/**
 * 純 PHP 定時任務守護進程
 * 部署方式:php cron_daemon.php & (Linux) 或 瀏覽器訪問一次後關閉頁面
 */
ignore_user_abort(true);   // 1. 忽略用戶斷開,進入後台運行
set_time_limit(0);         // 2. 移除執行時間限制

$interval = 60;            // 執行間隔:60 秒
$logFile  = __DIR__ . '/cron_daemon.log';

/** 記錄日誌函數 */
function logMsg($msg) {
    global $logFile;
    file_put_contents($logFile, date('[Y-m-d H:i:s] ') . $msg . PHP_EOL, FILE_APPEND);
}

logMsg('守護進程啟動,PID: ' . getmypid());

// 防止多實例運行(簡易文件鎖)
$lockFile = __DIR__ . '/cron_daemon.lock';
if (file_exists($lockFile) && (time() - filemtime($lockFile) < 3600)) {
    logMsg('檢測到已有實例運行,退出。');
    exit;
}
file_put_contents($lockFile, getmypid());

register_shutdown_function(function() use ($lockFile) {
    @unlink($lockFile);
    logMsg('守護進程停止。');
});

/** 核心任務調度邏輯 */
while (true) {
    $start = microtime(true);
    
    // --- 在這裡編寫具體任務邏輯 ---
    // 示例:清理 7 天前的臨時文件
    $tmpDir = sys_get_temp_dir() . '/myapp_*';
    foreach (glob($tmpDir) as $file) {
        if (is_file($file) && (time() - filemtime($file) > 7 * 86400)) {
            @unlink($file);
            logMsg("清理過期文件: $file");
        }
    }
    // 示例:發送待發郵件隊列
    // send_queued_emails();
    // --------------------------------

    $elapsed = microtime(true) - $start;
    $sleepTime = max(1, $interval - $elapsed); // 動態調整睡眠時間,保持固定頻率
    
    logMsg(sprintf('本輪耗時: %.3fs, 休眠: %ds', $elapsed, $sleepTime));
    sleep($sleepTime);
}

方案選型建議

場景推薦方案關鍵配置
擁有 VPS/雲服務器根權限Crontab + CLI PHP配置 crontab -e,使用絕對路徑
共享虛擬主機、無 Shell 權限Web 觸發 + 定時外部請求第三方監控服務(如 UptimeRobot)每 5 分鐘請求一次觸發 URL
Windows 服務器(IIS/Apache)任務計劃程序 + php.exe操作:建立基本任務 → 觸發器 → 啟動程序 php.exe,參數 -f C:\path\cron.php
高併發、任務耗時長、需即時性消息隊列 + Worker 進程Redis/RabbitMQ + Supervisor 管理多 Worker 進程
快速原型、臨時需求、無系統權限ignore_user_abort() 死循環需驗證主機是否禁用 set_time_limit、ignore_user_abort

避坑指南與最佳實踐

  1. 防止重複執行: 使用文件鎖、數據庫分布式鎖或 Redis SETNX 確保單實例運行。
  2. 內存管理: 長運行進程必須定期 gc_collect_cycles(),避免循環引用導致內存洩漏;大數據集處理用 Generator 迭代器。
  3. 異常捕獲: 核心循環包裹 try-catch,記錄異常堆棧後繼續運行,避免單個任務錯誤導致整個進程退出。
  4. 優雅退出: 捕獲 SIGTERM 信號(pcntl_signal),完成當前任務後退出,而非強制殺死。
  5. 日誌與監控: 記錄每次執行耗時、結果、異常;接入 Prometheus/Grafana 或簡單的健康檢查接口(如寫入心跳時間戳到 Redis)。

總結

PHP 定時任務沒有銀彈,選型取決於部署環境、業務量級與維護成本。生產環境首選 Crontab + CLI,穩健可控;虛擬主機退而求其次用 Web 觸發;ignore_user_abort() 方案適合快速驗證或特殊受限環境,但長期運行穩定性遜於系統級調度。無論選哪種,冪等性設計、鎖機制、日誌監控 才是保障任務可靠執行的基石。

copyright © 萬盛學電腦網 all rights reserved