萬盛學電腦網

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

PHP cURL 登入 QQ 獲取用戶資訊遭遇 SSL 憑證錯誤?兩行代碼快速解決

在開發 QQ 登入回調功能時,使用 file_get_contents() 請求 HTTPS API 端點常失敗;改用 cURL 卻報 SSL certificate problem: unable to get local issuer certificate。這是因為 PHP cURL 預設驗證伺服器 SSL 憑證鏈,而本地環境缺少最新 CA 憑證包。本文提供生產環境安全與開發環境快速驗證兩種解決路徑。

快速解決方案(開發/測試環境適用)

在 curl_init() 後、curl_exec() 前加入兩行選項,跳過對等端憑證與主機名驗證:

$ch = curl_init();
// ... 其他 curl_setopt 設定 ...

// 關閉 SSL 憑證驗證(僅限開發/測試環境!)
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

$response = curl_exec($ch);
curl_close($ch);
  • CURLOPT_SSL_VERIFYPEER = false:不驗證伺服器憑證是否由受信 CA 簽發
  • CURLOPT_SSL_VERIFYHOST = false:不檢查憑證中的 Common Name (CN) 是否與請求主機名匹配
⚠️ 安全警告: 生產環境嚴禁關閉驗證,否則易遭受中間人攻擊 (MITM)。請務必採用下方生產環境方案。

生產環境標準解決方案(推薦)

方法一:更新 CA 憑證包(最根治)

  1. 下載最新 cacert.pem (由 Mozilla 維護)
  2. 放置於伺服器固定路徑,如 /etc/ssl/certs/cacert.pem (Linux) 或 C:\php\cacert.pem (Windows)
  3. 修改 php.ini:
; Linux
curl.cainfo = /etc/ssl/certs/cacert.pem

; Windows
curl.cainfo = C:\php\cacert.pem
  • 重啟 PHP-FPM / Apache 生效
  • 方法二:程式碼指定 CA 檔案(不改 php.ini)

    curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem'); // 絕對路徑
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 2 為嚴格檢查 CN
    

    方法三:使用系統憑證存儲(Linux 發行版預設)

    大多數 Linux 發行版已內建 ca-certificates 套件,確保已安裝並更新:

    # Debian/Ubuntu
    apt-get update && apt-get install -y ca-certificates
    
    # CentOS/RHEL
    yum update -y ca-certificates
    

    PHP cURL 會自動讀取系統信任存儲 (通常在 /etc/ssl/certs/),無需額外配置。

    驗證修復是否生效

    $ch = curl_init('https://graph.qq.com/oauth2.0/me?access_token=YOUR_TOKEN');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); // 生產必須為 true
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
    
    $response = curl_exec($ch);
    if (curl_errno($ch)) {
        echo 'cURL Error: ' . curl_error($ch);
    } else {
        echo 'Success: ' . $response;
    }
    curl_close($ch);
    

    為什麼 CURLOPT_HTTPHEADER => ['Expect:'] 無效?

    網路上流傳的 curl_setopt($ch, CURLOPT_HTTPHEADER, ['Expect:']) 目的是禁用 HTTP/1.1 的 Expect: 100-continue 機制,解決某些舊版伺服器 (如 lighttpd 1.4) 回應 417 Expectation Failed 的問題。此設定與 SSL 憑證驗證無關,無法解決本文所述錯誤。

    總結建議

    環境推薦做法風險等級
    本地開發 / CI 測試暫時關閉驗證 (VERIFYPEER=false)低 (非實際流量)
    預發布 / Staging指定 cacert.pem 檔案中
    生產環境系統級 CA 憑證 + 定期自動更新零風險

    記住:SSL/TLS 憑證驗證是 HTTPS 安全的基石。花幾分鐘配置正確的 CA 憑證,能避免未來難以追蹤的安全事故。若專案使用 Composer,建議安裝 symfony/ca-cert-bundle 套件,它會自動維護最新 CA 憑證並整合至 PHP cURL/Guzzle/HttpClient。

    copyright © 萬盛學電腦網 all rights reserved