PHP 使用 cURL 通過 SOCKS5 代理獲取數據完整示例

場景介紹

爬蟲、API 聯調、跨區域訪問等場景常需通過代理服務器轉發請求。本文展示如何在 PHP 中使用 cURL 配置 SOCKS5 代理（含認證），並設置常用請求頭模擬真實瀏覽器行為。

完整代碼示例

 'value1', 'key2' => 'value2'];
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($param));

// 返回響應體而非直接輸出
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// ====== 代理核心配置 ======
// 使用 HTTP 隧道模式（SOCKS5 必須）
curl_setopt($curl, CURLOPT_HTTPPROXYTUNNEL, true);
// 代理認證方式
curl_setopt($curl, CURLOPT_PROXYAUTH, CURLAUTH_BASIC);
// 代理類型：SOCKS5
curl_setopt($curl, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5);
// 代理服務器地址
curl_setopt($curl, CURLOPT_PROXY, "180.186.11.121");
// 代理端口
curl_setopt($curl, CURLOPT_PROXYPORT, "37211");
// 代理認證憑證：用戶名:密碼
curl_setopt($curl, CURLOPT_PROXYUSERPWD, "taras:taras-ss5");

// 執行請求
$result = curl_exec($curl);

// 錯誤處理
if ($result === false) {
    echo 'cURL Error: ' . curl_error($curl);
} else {
    echo $result;
}

curl_close($curl);
?>

關鍵參數詳解

常見問題排查

• 連接超時：檢查代理 IP/端口是否存活，防火牆是否放行；嘗試 telnet proxy_ip port。
• 認證失敗：確認用戶名密碼正確，部分代理要求 CURLAUTH_NTLM。
• DNS 解析異常：改用 CURLPROXY_SOCKS5_HOSTNAME 讓代理端解析域名。
• HTTPS 目標站點：需確保代理支持 CONNECT 方法隧道傳輸 TLS 流量；若出現證書驗證錯誤，可暫時關閉 CURLOPT_SSL_VERIFYPEER（僅測試環境）。