| 方式 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| cURL | 功能最全 (HTTPS、代理、認證、超時控制、多請求並發)、性能最好、標準庫 | 需安裝擴展、API 相對繁瑣 | 生產環境首選、複雜 HTTP 交互 |
| file_get_contents + stream_context | 無依賴、語法簡潔、原生支持 HTTPS/POST/Header | 無法精細控制超時(僅總超時)、無進度回調、錯誤處理弱 | 簡單 GET/POST、快速腳本、禁用 cURL 環境 |
| fsockopen 原始 Socket | 完全控制協議細節、無依賴、可實現非標準協議 | 需手動構造 HTTP 協議、處理分塊編碼/Keep-Alive/SSL 极其繁瑣、易出錯 | 教學、特殊協議、極度受限環境 |
<?php
class Request {
/** cURL 版 (推薦) */
public static function post($url, $post_data = '', $timeout = 5) {
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $post_data,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => $timeout,
CURLOPT_TIMEOUT => $timeout,
CURLOPT_HEADER => false,
CURLOPT_SSL_VERIFYPEER => false, // 開發環境關閉驗證,生產請配置 CA
CURLOPT_SSL_VERIFYHOST => false,
]);
$response = curl_exec($ch);
$errno = curl_errno($ch);
$error = curl_error($ch);
curl_close($ch);
if ($errno) throw new Exception("cURL Error $errno: $error");
return $response;
}
/** Stream Context 版 */
public static function post2($url, array $data) {
$postdata = http_build_query($data);
$opts = [
'http' => [
'method' => 'POST',
'header' => 'Content-Type: application/x-www-form-urlencoded\r\nContent-Length: ' . strlen($postdata),
'content' => $postdata,
'timeout' => 5, // 僅支持總超時
],
'ssl' => ['verify_peer' => false, 'verify_peer_name' => false], // 開發環境
];
$context = stream_context_create($opts);
$result = @file_get_contents($url, false, $context);
if ($result === false) throw new Exception('file_get_contents 失敗');
return $result;
}
/** 原始 Socket 版 (教學用) */
public static function post3($host, $path, $query, $extraHeaders = '') {
$request = "POST $path HTTP/1.1\r\n";
$request .= "Host: $host\r\n";
$request .= "Content-Type: application/x-www-form-urlencoded\r\n";
$request .= $extraHeaders;
$request .= "User-Agent: PHP-Socket/1.0\r\n";
$request .= "Content-Length: " . strlen($query) . "\r\n";
$request .= "Connection: close\r\n\r\n";
$request .= $query;
$fp = @fsockopen($host, 80, $errno, $errstr, 5);
if (!$fp) throw new Exception("Socket 連接失敗: $errstr ($errno)");
fwrite($fp, $request);
$response = '';
while (!feof($fp)) {
$response .= fread($fp, 8192);
}
fclose($fp);
return $response; // 包含 HTTP 響應頭,需自行分離
}
}
$url = 'https://api.example.com/notify';
$data = ['order_id' => 12345, 'amount' => 99.9, 'sign' => 'abc123'];
try {
// 方式 1:cURL (推薦)
$ret = Request::post($url, http_build_query($data), 10);
echo "cURL: $ret\n";
// 方式 2:Stream
$ret = Request::post2($url, $data);
echo "Stream: $ret\n";
// 方式 3:Socket (需拆解 host/path)
$parsed = parse_url($url);
$ret = Request::post3($parsed['host'], $parsed['path'] . '?' . $parsed['query'], http_build_query($data));
echo "Socket: $ret\n";
} catch (Exception $e) {
echo "Error: " . $e->getMessage();
}
function multiPost(array $urls, array $dataList, $timeout = 10) {
$mh = curl_multi_init();
$handles = [];
foreach ($urls as $i => $url) {
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($dataList[$i]),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => $timeout,
]);
curl_multi_add_handle($mh, $ch);
$handles[$i] = $ch;
}
$running = null;
do {
curl_multi_exec($mh, $running);
curl_multi_select($mh, 0.1);
} while ($running > 0);
$results = [];
foreach ($handles as $i => $ch) {
$results[$i] = curl_multi_getcontent($ch);
curl_multi_remove_handle($mh, $ch);
curl_close($ch);
}
curl_multi_close($mh);
return $results;
}
CURLOPT_CONNECTTIMEOUT (連接) 和 CURLOPT_TIMEOUT (總執行)。curl_errno()、HTTP 狀態碼 (curl_getinfo($ch, CURLINFO_HTTP_CODE))。CURLOPT_SSL_VERIFYPEER 並配置 CURLOPT_CAINFO。掌握三種 POST 方式的優劣與適用邊界,封裝統一 Request 類,生產環境堅持 cURL + 完善異常處理 + 監控告警,是穩健 HTTP 客戶端的基石。