Linux crontab 是排程執行 PHP CLI 腳本的標準方式。本文涵蓋 crontab 語法詳解、PHP 專用寫法、環境變量陷阱、日誌重定向、鎖機制防並發、Laravel/Symfony 調度器集成,助你構建可靠的定時任務體系。
# 編輯當前用戶 crontab
crontab -e
# 查看當前任務
crontab -l
# 刪除所有任務
crontab -r
* * * * * 執行命令
- - - - -
| | | └── 星期 (0-7) (0 或 7 代表星期日)
| | └──── 月份 (1-12)
| └────── 日期 (1-31)
└──────── 小時 (0-23)
───────── 分鐘 (0-59)
# ❌ 錯誤:環境變量缺失,php 命令找不到
0 * * * * php -f /home/user/update.php
# ✅ 正確:PHP 二進制絕對路徑 + 腳本絕對路徑
0 * * * * /usr/bin/php -f /home/user/update.php >> /home/user/logs/update.log 2>&1
# 獲取 PHP 路徑
which php
# /usr/bin/php
| 符號 | 含義 | 示例 |
|---|---|---|
* | 任意值 | * * * * * 每分鐘 |
- | 範圍 | 0 9-18 * * * 工作日 9-18 點整點 |
, | 枚舉 | 0,30 * * * * 每小時 0 分和 30 分 |
/ | 步長 | */10 * * * * 每 10 分鐘 |
| 組合 | 範圍+步長 | 0-30/5 * * * * 前 30 分鐘每 5 分鐘 |
# 每天 02:30 執行備份腳本,輸出日誌、鎖防並發、捕獲異常
30 2 * * * /usr/bin/flock -n /tmp/backup.lock -c "/usr/bin/php -f /var/www/artisan backup:run >> /var/www/storage/logs/cron_backup.log 2>&1"
# 每 5 分鐘檢查隊列工作進程,自動拉起
*/5 * * * * /usr/bin/pgrep -f "queue:work" >/dev/null || /usr/bin/php -f /var/www/artisan queue:work --daemon >> /var/www/storage/logs/cron_queue.log 2>&1
PATH=/usr/local/bin:/usr/bin:/bin、APP_ENV=production 寫在 crontab 文件頭部。flock -n /tmp/task.lock -c "cmd",避免上次執行未結束導致重疊。>> /path/log 2>&1,便於事後排查。www-data 或 cronuser,禁止 root 直接跑業務腳本。INSERT IGNORE、UPDATE ... WHERE status=pending)。# crontab 僅需一行
* * * * * cd /var/www && /usr/bin/php artisan schedule:run >> /dev/null 2>&1
// app/Console/Kernel.php
protected function schedule(Schedule $schedule) {
$schedule->command('backup:run')->dailyAt('02:30');
$schedule->job(new CheckQueueHealth)->everyFiveMinutes();
$schedule->call(fn() => Cache::flush())->hourly();
}
優勢:PHP 代碼定義調度、可視化、支援時區、單任務防重疊 ->withoutOverlapping()、維護窗口 ->between()、環境感知 ->environments()。
同理,將調度邏輯遷入應用代碼,crontab 只保留心跳觸發器。
crontab -l 確認任務存在grep CRON /var/log/syslog 查看執行記錄/usr/bin/php -f /path/script.php#!/usr/bin/env php 與執行權限 chmod +xMAILTO="" 避免郵件堵塞郵箱掌握 Crontab 與框架調度器雙模式,讓定時任務從「黑盒定時炸彈」變為「可觀測、可控制、可演進」的基礎設施組件。