萬盛學電腦網

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

Linux Crontab 定時執行 PHP 腳本完整指南:語法詳解、常見坑點、系統級與框架級最佳實踐

Linux crontab 是排程執行 PHP CLI 腳本的標準方式。本文涵蓋 crontab 語法詳解、PHP 專用寫法、環境變量陷阱、日誌重定向、鎖機制防並發、Laravel/Symfony 調度器集成,助你構建可靠的定時任務體系。

基礎操作

# 編輯當前用戶 crontab
crontab -e

# 查看當前任務
crontab -l

# 刪除所有任務
crontab -r

Crontab 語法詳解

* * * * *  執行命令
- - - - -
| | | └── 星期 (0-7) (0 或 7 代表星期日)
| | └──── 月份 (1-12)
| └────── 日期 (1-31)
└──────── 小時 (0-23)
───────── 分鐘 (0-59)

PHP 專用寫法:必須使用絕對路徑

# ❌ 錯誤:環境變量缺失,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

關鍵最佳實踐

  1. 絕對路徑三件套:PHP 二進制、腳本文件、日誌文件全用絕對路徑。
  2. 環境變量顯式聲明:PATH=/usr/local/bin:/usr/bin:/bin、APP_ENV=production 寫在 crontab 文件頭部。
  3. 防並發鎖:flock -n /tmp/task.lock -c "cmd",避免上次執行未結束導致重疊。
  4. 標準輸出/錯誤重定向:>> /path/log 2>&1,便於事後排查。
  5. 執行用戶權限最小化:建議專用 www-data 或 cronuser,禁止 root 直接跑業務腳本。
  6. 幂等性設計:腳本可重複安全執行(如用 INSERT IGNORE、UPDATE ... WHERE status=pending)。

框架級調度器:脫離 Crontab 的現代選擇

Laravel Scheduler

# 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()。

Symfony Messenger + Scheduler Bundle / RoadRunner

同理,將調度邏輯遷入應用代碼,crontab 只保留心跳觸發器。

故障排查清單

  • crontab -l 確認任務存在
  • grep CRON /var/log/syslog 查看執行記錄
  • 手動執行命令驗證:/usr/bin/php -f /path/script.php
  • 檢查腳本首行 #!/usr/bin/env php 與執行權限 chmod +x
  • 檢查 MAILTO="" 避免郵件堵塞郵箱

掌握 Crontab 與框架調度器雙模式,讓定時任務從「黑盒定時炸彈」變為「可觀測、可控制、可演進」的基礎設施組件。

copyright © 萬盛學電腦網 all rights reserved