萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP cURL 在 IPv6 環境下超時問題的解決方案

問題現象

服務器啟用 IPv6 後,cURL 請求間歇性超時。日誌顯示連接階段耗時極長,最終觸發 CURLOPT_CONNECTTIMEOUT / CURLOPT_TIMEOUT。

根因分析

cURL 默認啟用 Happy Eyeballs 算法(RFC 8305),並行嘗試 IPv6 和 IPv4 連接。若目標域名**只有 A 記錄(IPv4)**,IPv6 解析會等待 DNS AAAA 記錄查詢超時(通常 5-30 秒),才回退到 IPv4,導致整體請求超時。

解決方案:強制使用 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;
}

版本要求

  • PHP ≥ 5.3
  • libcurl ≥ 7.10.8(現代 Linux 發行版均滿足)
  • 常量 CURL_IPRESOLVE_V4 / CURL_IPRESOLVE_V6 / CURL_IPRESOLVE_WHATEVER (默認)

進階:雙棧環境下的最佳實踐

  1. 優先 IPv4,允許回退 IPv6(推薦):
    CURLOPT_IPRESOLVE => CURL_IPRESOLVE_WHATEVER(默認),但確保 CURLOPT_CONNECTTIMEOUT 設置合理(如 3-5 秒),讓 Happy Eyeballs 快速回退。
  2. 域名同時有 A/AAAA 記錄:保持默認,享受雙棧優勢。
  3. 僅 IPv6 環境(稀有):設置 CURL_IPRESOLVE_V6。

系統級優化(可選)

  • /etc/gai.conf 調整 `precedence` 策略,優先 IPv4。
  • DNS 服務器返回 AAAA 記錄極慢時,考慮本地 DNS 緩存(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');
}
copyright © 萬盛學電腦網 all rights reserved