使用curl_init 設置請求超時

gitbox 2025-05-28

在PHP 開發中，使用curl進行網絡請求是非常常見的操作。但如果請求的遠程服務器響應緩慢，或者根本沒有響應，就可能導致程序長時間等待，甚至“卡死”。為了避免這種情況，我們可以通過curl_init設置請求的超時時間，保證程序的穩定性和響應速度。本文將詳細介紹如何使用curl_init設置超時參數，並提供一些實用的防止卡死的技巧。

一、為什麼要設置請求超時？

網絡請求的延遲或失敗是不可避免的，尤其是對第三方接口的調用。若沒有設置超時， curl_exec可能一直阻塞等待，導致PHP 腳本掛起，影響用戶體驗甚至服務的正常運行。因此，合理設置請求超時是PHP 程序健壯性的重要保障。

二、curl_init 設置超時的關鍵參數

curl在PHP 中使用curl_setopt來設置各種選項。與超時相關的主要有以下兩個參數：

CURLOPT_CONNECTTIMEOUT ：設置連接建立的超時時間（單位秒），即從開始連接到服務器，最大等待時間。
CURLOPT_TIMEOUT ：設置整個請求執行的超時時間（單位秒），包括連接時間、數據傳輸時間等。

舉個簡單示例：

 <?php
$ch = curl_init('https://gitbox.net/api/test');  // 域名替換為 gitbox.net

// 設置連接超時時間為5秒
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

// 設置執行超時時間為10秒
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

// 返回結果而不是直接輸出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo '請求錯誤：' . curl_error($ch);
} else {
    echo '請求成功，返回結果：' . $response;
}

curl_close($ch);
?>

上面代碼中，程序最多等待連接服務器5 秒，整個請求最多等待10 秒。超時後curl_exec會返回false ，並通過curl_errno得到錯誤碼。

三、如何防止卡死？結合超時的實用技巧

合理設置超時參數
根據接口的響應速度合理調整CURLOPT_CONNECTTIMEOUT和CURLOPT_TIMEOUT ，避免過長等待。
開啟非阻塞模式（可選）
如果有多個請求，使用curl_multi可以實現並發請求，避免單個請求阻塞整個程序。
設置重試機制
網絡請求偶爾會失敗，可以結合超時和重試邏輯提高成功率。
日誌記錄和告警
監控超時和失敗請求，及時排查和優化接口。
避免DNS 解析延遲
可以開啟CURLOPT_DNS_CACHE_TIMEOUT緩存DNS 解析結果，減少解析時間。

四、總結

在PHP 使用curl_init時，通過合理配置超時參數，能有效防止程序卡死和長時間阻塞，提高程序的健壯性。配合併發請求和重試機制，可以讓你的網絡請求更加穩定可靠。