在開發 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) 是否與請求主機名匹配/etc/ssl/certs/cacert.pem (Linux) 或 C:\php\cacert.pem (Windows)php.ini:; Linux
curl.cainfo = /etc/ssl/certs/cacert.pem
; Windows
curl.cainfo = C:\php\cacert.pem
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 發行版已內建 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。