阿里雲 ACE(App Cloud Engine)提供的 Cron 服務 是分散式定時任務平台,語法與 Linux crontab 完全一致,但透過 PHP API 管理而非編輯檔案。任務以 HTTP 請求觸發 PHP 腳本執行,單次執行上限 30 秒,連續 5 次失敗自動刪除任務。
* * * * * *
分 時 日 月 週 (第六欄為秒,ACE 擴充)
| 欄位 | 範圍 | 說明 |
|---|---|---|
| 分 | 0~59 | |
| 時 | 0~23 | |
| 日 | 1~31 | |
| 月 | 1~12 | |
| 週 | 0~6 | 0=星期日 |
| 秒 | 0~59 | ACE 擴充欄位 |
範例:2/5 12-14 * * * * → 每天 12:00~14:00,每整點第 2 分起每 5 分鐘執行一次。
cron_add()string cron_add(string $scheduler, string $url, [string $timezone = 'GMT-8'])
| 參數 | 說明 |
|---|---|
| scheduler | Cron 表達式(含秒欄位) |
| url | 執行腳本相對路徑,如 cron/backup.php |
| timezone | 時區,預設 GMT-8(北京時間) |
回傳:成功回傳 cron_id(任務編號),失敗回傳 false。
cron_delete()bool cron_delete(string $cron_id)
回傳:成功 true,失敗 false。
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);
?>