服務器啟用 IPv6 後,cURL 請求間歇性超時。日誌顯示連接階段耗時極長,最終觸發 CURLOPT_CONNECTTIMEOUT / CURLOPT_TIMEOUT。
cURL 默認啟用 Happy Eyeballs 算法(RFC 8305),並行嘗試 IPv6 和 IPv4 連接。若目標域名**只有 A 記錄(IPv4)**,IPv6 解析會等待 DNS AAAA 記錄查詢超時(通常 5-30 秒),才回退到 IPv4,導致整體請求超時。
設置 CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V4,告訴 cURL 僅解析/連接 IPv4 地址。
<?php
function curlGet($url, int $timeout = 10): ?string {
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => $timeout,
CURLOPT_TIMEOUT => $timeout * 3,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_USERAGENT => 'MyApp/1.0',
CURLOPT_SSL_VERIFYPEER => true,
// 關鍵:強制 IPv4
CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V4,
]);
$response = curl_exec($ch);
if ($response === false) {
error_log("cURL error [{$ch}]: " . curl_error($ch));
return null;
}
curl_close($ch);
return $response;
}
CURL_IPRESOLVE_V4 / CURL_IPRESOLVE_V6 / CURL_IPRESOLVE_WHATEVER (默認)CURLOPT_IPRESOLVE => CURL_IPRESOLVE_WHATEVER(默認),但確保 CURLOPT_CONNECTTIMEOUT 設置合理(如 3-5 秒),讓 Happy Eyeballs 快速回退。CURL_IPRESOLVE_V6。/etc/gai.conf 調整 `precedence` 策略,優先 IPv4。nscd/systemd-resolved)或編輯 /etc/hosts 直連 IPv4。<?php
$urls = [
'https://ipv4.google.com', // 僅 IPv4
'https://ipv6.google.com', // 僅 IPv6
'https://www.example.com', // 雙棧
];
foreach ($urls as $url) {
$start = microtime(true);
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_TIMEOUT => 10,
CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V4, // 測試強制 v4
]);
$ok = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);
printf("%-30s %s %.3fs IP:%s\n", $url, $ok ? 'OK' : 'FAIL', microtime(true)-$start, $info['primary_ip'] ?? 'N/A');
}