PHP set_time_limit 函數詳解：動態控制腳本最大執行時間

函數簽名與行為

void set_time_limit(int $seconds)

• 功能：設定腳本允許執行的最大秒數，0 表示無限制
• 重置計時器：每次呼叫都會**從零重新計時**，而非累加
• 優先順序：運行時設定 > php.ini max_execution_time
• 安全模式限制：safe_mode = On 時函數失效 (PHP 5.4+ 已移除安全模式)

計時機制範例

<?php
// php.ini: max_execution_time = 30

set_time_limit(20); // 重置計時器，剩餘 20 秒
sleep(10);          // 經過 10 秒
set_time_limit(30); // 再次重置，剩餘 30 秒 (非 20+30)
// 總共可執行 10 + 30 = 40 秒
?>

適用範圍與限制

常見使用場景

<?php
// 1. 長時間批次處理
set_time_limit(0); // 無限制
foreach ($largeDataset as $item) {
    processItem($item);
    // 定期釋放記憶體
    if ($count++ % 1000 === 0) gc_collect_cycles();
}

// 2. 分段延長 (避免無限循環掛死)
function longTask() {
    $maxSegments = 10;
    $segmentTime = 30; // 每段 30 秒
    
    for ($i = 0; $i < $maxSegments; $i++) {
        set_time_limit($segmentTime);
        doSegmentWork($i);
    }
}

// 3. 命令列腳本 (CLI) 預設無限制
// php.ini: max_execution_time = 0 (CLI SAPI)
// Web 環境下才需手動調整
?>

替代方案：register_shutdown_function

<?php
// 腳本即將超時時執行清理
register_shutdown_function(function () {
    $error = error_get_last();
    if ($error && $error['type'] === E_ERROR) {
        // 記錄超時錯誤、釋放鎖、發送告警
        error_log("Script timeout: " . $error['message']);
    }
});

// 模擬長時間任務
set_time_limit(5);
sleep(10); // 這裡會觸發 Fatal Error 後執行 shutdown function
?>

最佳實踐

1. CLI 長任務：預設無限制，配合 pcntl_fork 或 Swoole 異步處理
2. Web 請求：預設 30 秒足夠 99% 情況，避免設為 0
3. 大檔案匯出：分塊輸出 + set_time_limit(300) 定期重置
4. 監控告警：結合 XHProf/Blackfire 監控實際執行時間分布

善用 set_time_limit 控制執行邊界，配合分批處理模式，平衡功能完整性與系統穩定性。