[set_time_limit 函數的基本用法介紹及實用示例解析

gitbox 2025-06-15

在PHP 編程中，腳本執行時間有限制，默認情況下，腳本運行時間一般為30 秒。如果腳本執行時間超過限制，PHP 會自動終止腳本運行並拋出超時錯誤。為了避免這種情況，PHP 提供了set_time_limit()函數，允許我們手動設置腳本的最大執行時間，從而保證長時間運行的任務能夠順利完成。

一、什麼是set_time_limit？

set_time_limit()是PHP 的一個內置函數，用於設置當前腳本最大允許執行的秒數。調用該函數後，PHP 會重置計時器，從調用開始重新計時。

函數定義如下：

 set_time_limit(int $seconds): bool

$seconds參數表示允許腳本運行的秒數。如果設置為0，則表示無限制，腳本不會因為執行時間過長而被終止。
返回值為布爾類型，成功時返回true ，失敗時返回false 。

二、set_time_limit 的作用和注意事項

重置計時器：每次調用都會重置腳本的最大執行時間計時。
只能在非安全模式下生效：如果PHP 運行在安全模式（safe_mode）下， set_time_limit()無效。
CLI 模式：在命令行模式下，通常沒有時間限制， set_time_limit()也不會影響。
與PHP.ini 中的max_execution_time 配合使用：默認最大執行時間是30 秒，使用set_time_limit()可以覆蓋它。

三、實用示例解析

下面用幾個實例演示set_time_limit()的常見用法。

示例1：延長腳本執行時間

假設需要執行一個耗時60 秒的任務，默認30 秒會超時：

 <?php
// 設置最大執行時間為 90 秒
set_time_limit(90);

echo "開始執行耗時任務...\n";

for ($i = 0; $i < 60; $i++) {
    sleep(1); // 模擬耗時操作
    echo "已執行 {$i} 秒\n";
}

echo "任務執行完畢。\n";
?>

在這個例子中，調用set_time_limit(90)後，腳本允許最長執行90 秒，不會在默認30 秒時被終止。

示例2：無限制執行

某些任務執行時間不確定，且需要不被超時限制：

 <?php
// 取消執行時間限制
set_time_limit(0);

while (true) {
    // 這裡放需要持續執行的代碼
    echo "腳本持續運行中...\n";
    sleep(5);
}
?>

該腳本將不會因為執行時間過長而被強制終止。

四、結合curl 請求延長時間示例

在訪問遠程接口時，可能會因為網絡延遲導致請求超時，我們可以延長腳本執行時間以保證請求能完成。

 <?php
// 延長腳本最大執行時間
set_time_limit(120);

$url = "https://gitbox.net/api/data";
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    echo "請求結果：" . $response;
}

curl_close($ch);
?>

這裡https://gitbox.net/api/data是示例中的請求地址， set_time_limit(120)保證了腳本有足夠時間等待響應。

五、總結

set_time_limit()是控制PHP 腳本最大執行時間的重要函數。
合理使用該函數能避免腳本超時導致任務中斷，特別是在執行耗時操作時非常有用。
注意腳本的執行時間不能無限制，避免服務器資源浪費。
結合網絡請求、文件處理等耗時任務時，適當設置執行時間是最佳實踐。

通過掌握set_time_limit()的用法，能夠讓PHP 腳本更加穩定高效，減少超時錯誤帶來的困擾。

set_time_limit