Windows 任務計劃程序定時執行 PHP 腳本：圖文教程、參數詳解、常見錯誤排查

適用場景

• 定時備份數據庫、清理日誌、生成報表
• 定時發送郵件、推送通知、同步第三方數據
• 游戲/應用後台：怪物刷新、排行榜更新、任務過期檢測

核心原理

Windows 任務計劃程序 相當於 Linux `cron`。它在指定時間啟動 `php.exe` 進程，傳入腳文件路徑作為參數執行。PHP 腳本以 **CLI 模式** 運行，無 Web 服務器參與，無超時限制（默認），可訪問完整文件系統。

圖文配置步驟 (Windows Server 2016/2019 / Windows 10/11)

1. 打開任務計劃程序

Win+R → `taskschd.msc` → 回車
或：控制面板 → 系統和安全 → 管理工具 → 任務計劃程序

2. 創建基本任務

右側操作欄 → **創建基本任務** → 名稱：`PHP_Backup_DB` → 描述：`每天凌晨 2 點備份 MySQL` → 下一步

3. 觸發器設置

• **每天** → 開始：`2024-01-01 02:00:00` → 間隔：`1 天`
• 進階設置：可勾選「重複任務間隔：1 小時，持續：24 小時」實現每小時執行

4. 操作：啟動程序 (關鍵步驟)

**完整命令行等效**：

"C:\php\php.exe" -f "C:\www\scripts\backup_db.php"

5. 完成向導，設置賬號權限

• 勾選「**無論用戶是否登錄都要運行**」
• 勾選「**使用最高權限運行**」
• 點擊「確定」輸入密碼（當前用戶或專用服務賬號）

PHP 腳本編寫規範 (CLI 環境)

<?php
// backup_db.php
// 1. 設置無限執行時間、內存
set_time_limit(0);
ini_set('memory_limit', '512M');

// 2. 禁用輸出緩衝，實時輸出日誌
while (ob_get_level()) ob_end_clean();
ini_set('implicit_flush', 1);

// 3. 設置工作目錄為腳本所在目錄 (防止相對路徑錯誤)
chdir(dirname(__FILE__));

// 4. 載入配置/自動加載
require_once __DIR__ . '/../vendor/autoload.php';
$config = require __DIR__ . '/../config/db.php';

// 5. 業務邏輯
try {
    $pdo = new PDO($config['dsn'], $config['user'], $config['pass']);
    $sql = "SELECT * INTO OUTFILE '/backups/users_" . date('Ymd') . ".csv' FIELDS TERMINATED BY ',' FROM users";
    $pdo->exec($sql);
    echo "[" . date('H:i:s') . "] Backup completed.\n";
} catch (Exception $e) {
    error_log("[" . date('H:i:s') . "] Backup failed: " . $e->getMessage());
    exit(1); // 非零退出碼，任務計劃可記錄失敗
}

// 6. 退出碼：0=成功，非0=失敗
exit(0);
?>

高級技巧與最佳實踐

1. 避免多實例並發運行

<?php
// 腳本開頭加入文件鎖
$lockFile = sys_get_temp_dir() . '/backup_db.lock';
$fp = fopen($lockFile, 'c+');
if (!flock($fp, LOCK_EX | LOCK_NB)) {
    echo "另一實例正在運行，退出。\n";
    exit(0);
}
// 註冊釋放
register_shutdown_function(function() use ($fp, $lockFile) {
    flock($fp, LOCK_UN);
    fclose($fp);
    @unlink($lockFile);
});
?>

2. 記錄結構化日誌到文件 (而非依賴任務計劃歷史)

$logFile = __DIR__ . '/../logs/backup_' . date('Y-m') . '.log';
$msg = json_encode([
    'time' => date('c'),
    'script' => basename(__FILE__),
    'status' => 'success',
    'duration_ms' => (microtime(true) - $start) * 1000,
], JSON_UNESCAPED_UNICODE);
file_put_contents($logFile, $msg . PHP_EOL, FILE_APPEND | LOCK_EX);

3. 參數化腳本，複用邏輯

"C:\php\php.exe" -f "C:\www\scripts\backup.php" -- --db=users --type=full --compress=gzip
// 腳本內獲取：$options = getopt('', ['db:', 'type:', 'compress:']);

4. 使用專用服務賬號 (而非管理員)

• 創建標準用戶 `svc_php_tasks`
• 授予：讀寫腳本目錄、讀寫數據目錄、讀寫日誌目錄、登錄為批處理作業權限 (`SeBatchLogonRight`)
• 任務計劃「無論用戶是否登錄都要運行」選擇此賬號

常見錯誤排查表

替代方案：更強大的調度器