萬盛學電腦網

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

Linux 實現 PHP 定時任務最佳實踐:Cron + Shell 包裝器(避開 sleep 死循環坑)

PHP 本身無內建排程機制,常見錯誤做法是 ignore_user_abort() + set_time_limit(0) + sleep() 死循環,極易造成記憶體洩漏、程序殭屍、部署維護困難。正確做法:PHP 腳本只負責單次業務邏輯,排程交給 OS 層級的 Cron。本文以 RedHat/CentOS/Ubuntu 為例,完整示範 Shell 包裝、crontab 編寫、日誌輪轉、併發防護、監控告警。

核心架構

cron (crond)
  └─ 每分鐘/小時/天 執行 /usr/local/bin/php-cron-wrapper.sh demo.php
        └─ wrapper.sh 鎖檔防併發 → 呼叫 php demo.php → 記錄日誌/退出碼

1. PHP 業務腳本(單次執行、無死循環)

<?php
// demo.php
require_once __DIR__ . '/vendor/autoload.php';

try {
    // 業務邏輯:同步訂單、發送郵件、清理快取...
    $result = (new \App\Task\SyncOrders())->run();
    echo "OK: " . json_encode($result, JSON_UNESCAPED_UNICODE) . PHP_EOL;
    exit(0);
} catch (Throwable $e) {
    fwrite(STDERR, "FAIL: " . $e->getMessage() . PHP_EOL);
    exit(1); // 非零退出碼讓 Cron 記錄失敗
}

2. Shell 包裝器(防併發鎖、日誌、環境變數)

#!/bin/bash
# /usr/local/bin/php-cron-wrapper.sh
# 用法:php-cron-wrapper.php /path/to/script.php [args...]

set -euo pipefail

SCRIPT="$1"
shift || { echo "Usage: $0  [args...]"; exit 1; }

# 唯一鎖鍵(腳本路徑 + 參數)
LOCK_KEY=$(echo "$SCRIPT $*" | md5sum | cut -d' ' -f1)
LOCK_FILE="/var/lock/php-cron-${LOCK_KEY}.lock"

# 非阻塞獨佔鎖(flock -n)
exec 9>"$LOCK_FILE"
if ! flock -n 9; then
    echo "[$(date '+%F %T')] Another instance running, skip." >&2
    exit 0
fi

# 載入 PHP 環境(若非系統預設)
export PHP_INI_SCAN_DIR=/etc/php.d
PHP_BIN=${PHP_BIN:-/usr/bin/php}

# 執行並記錄耗時
START=$(date +%s%3N)
"$PHP_BIN" "$SCRIPT" "$@" 2>&1 | while IFS= read -r line; do
    echo "[$(date '+%F %T')] $line"
done
EXIT_CODE=${PIPESTATUS[0]}
END=$(date +%s%3N)

echo "[$(date '+%F %T')] Finished in $((END-START)) ms, exit=$EXIT_CODE" >&2
exit $EXIT_CODE

授權:chmod +x /usr/local/bin/php-cron-wrapper.sh

3. Crontab 設定範例

# 每天 02:30 執行訂單同步
30 2 * * * /usr/local/bin/php-cron-wrapper.sh /var/www/html/tasks/sync_orders.php >> /var/log/cron/sync_orders.log 2>&1

# 每 5 分鐘檢查待發郵件(需防併發)
*/5 * * * * /usr/local/bin/php-cron-wrapper.sh /var/www/html/tasks/send_pending_mail.php >> /var/log/cron/send_mail.log 2>&1

# 每月 1 號 03:00 清理臨時檔
0 3 1 * * /usr/local/bin/php-cron-wrapper.sh /var/www/html/tasks/cleanup_temp.php >> /var/log/cron/cleanup.log 2>&1

4. 系統級 Cron 目錄(免編輯 crontab)

將包裝器腳本連結至系統預排程目錄:

# 每小時
ln -s /usr/local/bin/php-cron-wrapper.sh /etc/cron.hourly/sync_orders
# 每天
ln -s /usr/local/bin/php-cron-wrapper.sh /etc/cron.daily/cleanup_temp
# 每週
ln -s /usr/local/bin/php-cron-wrapper.sh /etc/cron.weekly/weekly_report
# 每月
ln -s /usr/local/bin/php-cron-wrapper.sh /etc/cron.monthly/monthly_bill

注意:放入 cron.* 目錄的腳本**必須為可執行檔**且**無副檔名**,且會以 root 身分執行,請在腳本內 su -s /bin/bash -c "..." www-data 降權。

5. 進階:systemd Timer(現代 Linux 推薦替代 Cron)

# /etc/systemd/system/sync-orders.service
[Unit]
Description=Sync Orders PHP Task
[Service]
Type=oneshot
User=www-data
ExecStart=/usr/bin/php /var/www/html/tasks/sync_orders.php
StandardOutput=journal
StandardError=journal

# /etc/systemd/system/sync-orders.timer
[Unit]
Description=Run sync-orders daily 02:30
[Timer]
OnCalendar=*-*-* 02:30:00
Persistent=true
[Install]
WantedBy=timers.target

啟用:systemctl daemon-reload && systemctl enable --now sync-orders.timer

監控與告警

  • 日誌集中:所有 Cron 輸出導向 /var/log/cron/,配合 Logrotate 每日切割、保留 30 天。
  • 健康檢查:curl -f https://localhost/healthz 或檢查 cron.log 最近是否有 exit=0 記錄。
  • 告警:Promtail + Loki + Grafana 設定 exit_code != 0 告警;或簡單用 cronic 工具只在失敗時發郵件。

為什麼不推薦 PHP 內部 sleep 循環?

copyright © 萬盛學電腦網 all rights reserved
缺點說明
記憶體洩漏長期運行未釋放資源(PDO 連線、快取陣列)導致 OOM
程序殭屍父進程異常退出、信號處理不當產生孤兒進程
部署困難代碼變更需重啟進程,無法優雅熱更
不可觀測無標準日誌、退出碼、監控指標
單點故障一台機器掛掉所有任務停擺