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 → 記錄日誌/退出碼
<?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 記錄失敗
}
#!/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
# 每天 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
將包裝器腳本連結至系統預排程目錄:
# 每小時
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 降權。
# /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
/var/log/cron/,配合 Logrotate 每日切割、保留 30 天。curl -f https://localhost/healthz 或檢查 cron.log 最近是否有 exit=0 記錄。exit_code != 0 告警;或簡單用 cronic 工具只在失敗時發郵件。| 缺點 | 說明 |
|---|---|
| 記憶體洩漏 | 長期運行未釋放資源(PDO 連線、快取陣列)導致 OOM |
| 程序殭屍 | 父進程異常退出、信號處理不當產生孤兒進程 |
| 部署困難 | 代碼變更需重啟進程,無法優雅熱更 |
| 不可觀測 | 無標準日誌、退出碼、監控指標 |
| 單點故障 | 一台機器掛掉所有任務停擺 |