阿里雲 ACE 平台提供的 Cron 服務為開發者提供 分布式定時任務調度 能力,語法與 Linux crontab 完全兼容,但通過 PHP API 管理而非編輯檔案。本文詳細說明使用規則、API 文檔、調度語法、執行限制與最佳實踐。
cron_add/cron_delete/cron_list 動態管理* * * * * *
│ │ │ │ └─ 星期 (0-6) (0=週日)
│ │ │ └──── 月份 (1-12)
│ │ └────── 日期 (1-31)
│ └───────── 小時 (0-23)
└──────────── 分鐘 (0-59)
| 排程表達式 | 含義 |
|---|---|
0 2 * * * * | 每天 02:00 執行 |
*/5 * * * * * | 每 5 分鐘執行 |
0 */2 * * * * | 每 2 小時整點執行 |
0 9-18/2 * * 1-5 * | 工作日 9-18 點每 2 小時 |
30 3 1 * * * | 每月 1 號 03:30 |
2/5 12-14 * * * * | 每天 12-14 點,從 2 分開始每 5 分鐘 (官方示例) |
string cron_add(string $scheduler, string $url [, string $timezone = 'GMT-8'])
參數:
$scheduler:crontab 表達式 (6 欄位)$url:相對應用根目錄的腳本路徑,如 cron/backup.php$timezone:時區,預設 GMT-8 (北京時間)返回:成功返回 cron_id (字串),失敗返回 false
bool cron_delete(string $cron_id)
返回:成功 true,失敗 false
array cron_list()
返回:成功返回陣列:
[
['cronId'=>'1', 'app_id'=>'2', 'url'=>'cron/back.php',
'scheduler'=>'2/5 12-14 * * * *', 'timezone'=>'gmt-8'],
...
]
失敗返回 false
<?php
// 初始化腳本中配置 (如 bootstrap.php / install.php)
// 每天凌晨 2 點備份資料庫
$backup_id = cron_add('0 2 * * * *', 'cron/backup.php');
// 每小時清理過期緩存
$clean_id = cron_add('0 * * * * *', 'cron/clean_cache.php');
// 每週一 03:00 產生報表
$report_id = cron_add('0 3 * * 1 *', 'cron/weekly_report.php');
// 查詢現有任務
$tasks = cron_list();
var_dump($tasks);
// 刪除任務 (如需動態管理)
# cron_delete($backup_id);
?>
https:/// 發起 GET 請求ignore_user_abort(true); set_time_limit(0); 在 ACE 無效,受平台層面限制<?php
// cron/daily_bill.php
$date = date('Y-m-d', strtotime('-1 day'));
$lock_key = "cron:daily_bill:$date";
$mem = new Memcache(); $mem->init();
if (!$mem->add($lock_key, 1, 0, 86400)) {
exit("Already executed"); // 重複執行直接退出
}
try {
$billing->generateDailyBill($date);
$mem->set($lock_key, 2, 0, 86400); // 標記完成
echo "OK";
} catch (Exception $e) {
error_log($e->getMessage());
echo "FAILED: " . $e->getMessage(); // 仍返回 200,避免被刪除
}
?>
# 錯誤:所有租戶都在 0 0 * * * 執行備份 → 存儲/網路風暴
# 正確:引入隨機偏移
cron_add('*/30 2-4 * * *', 'cron/backup.php'); // 凌晨 2-4 點隨機半小時執行
// 後台管理介面動態增刪任務
// 新增
$cid = cron_add($schedule, $script);
// 刪除
cron_delete($cid);
// 列表
$list = cron_list();
| 傳統 crontab | ACE Cron |
|---|---|
| 編輯 /etc/crontab 或 crontab -e | PHP 代碼調用 cron_add() |
| 直接執行 Shell/腳本 | HTTP 觸發 PHP 腳本 |
| 標準輸出/錯誤導向檔案 | error_log() / 存入資料庫 / 發送郵件 |
| 環境變數在 crontab 定義 | 應用配置/環境變數/配置中心 |
| 單機單點故障 | 分布式調度,高可用 |
timezone='GMT-8',勿依賴預設ACE Cron 將定時任務從「作業系統層面」提升至「應用層面」,配合分布式調度與 HTTP 觸發模型,讓定時任務具備與應用同等的彈性伸縮與高可用能力。