萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

阿里雲 ACE Cron 服務完整說明:分散式定時任務 PHP API 操作指南

服務簡介

阿里雲 ACE(App Cloud Engine)提供的 Cron 服務 是分散式定時任務平台,語法與 Linux crontab 完全一致,但透過 PHP API 管理而非編輯檔案。任務以 HTTP 請求觸發 PHP 腳本執行,單次執行上限 30 秒,連續 5 次失敗自動刪除任務。

核心限制

  • ⏱️ 單次執行最長 30 秒,超時需拆分任務
  • 🌐 僅對預設版本生效
  • 🔁 支援兩種模式:定點執行(如每天 5 點)與週期偏移執行(如每小時)

Cron 表達式語法(同 Linux crontab)

*    *    *    *    *    *
分   時   日   月   週   (第六欄為秒,ACE 擴充)
欄位範圍說明
分0~59
時0~23
日1~31
月1~12
週0~60=星期日
秒0~59ACE 擴充欄位

範例:2/5 12-14 * * * * → 每天 12:00~14:00,每整點第 2 分起每 5 分鐘執行一次。

PHP API 完整參考

1. 新增任務 cron_add()

string cron_add(string $scheduler, string $url, [string $timezone = 'GMT-8'])
參數說明
schedulerCron 表達式(含秒欄位)
url執行腳本相對路徑,如 cron/backup.php
timezone時區,預設 GMT-8(北京時間)

回傳:成功回傳 cron_id(任務編號),失敗回傳 false。

2. 刪除任務 cron_delete()

bool cron_delete(string $cron_id)

回傳:成功 true,失敗 false。

3. 查詢任務列表 cron_list()

array cron_list()

回傳陣列結構:

[
  ["cronId"=>"1", "app_id"=>"2", "url"=>"cron/back.php", 
   "scheduler"=>"2/5 12-14 * * * *", "timezone"=>"gmt-8"],
  ...
]

完整程式碼範例

<?php
// 新增:每天 12:00~14:00 每 5 分鐘備份一次
$cron_id = cron_add("2/5 12-14 * * * *", "cron/backup.php");
if ($cron_id) {
    echo "任務建立成功,ID: $cron_id\n";
} else {
    echo "建立失敗\n";
}

// 查詢所有任務
$list = cron_list();
print_r($list);

// 刪除特定任務
// $ret = cron_delete($cron_id);
?>

官方參考文檔

最佳實踐建議

  1. 冪等設計:腳本需可重複執行不產生副作用(如用鎖、檢查狀態)。
  2. 執行時間控制:單一腳本 < 20 秒,預留緩衝;長任務拆分為多個 Cron 串聯。
  3. 錯誤通知:腳本內捕獲異常並發送郵件/簡訊/鉤子通知。
  4. 日誌記錄:寫入資料表或檔案,便於事後追蹤。
  5. 版本管理:Cron 程式碼納入 Git,部署時自動註冊/更新任務。
copyright © 萬盛學電腦網 all rights reserved