萬盛學電腦網

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

PHP 發送 POST 請求三大方式:cURL、Stream Context、Socket 完整對比

場景對比

方式優點缺點適用場景
cURL功能最全 (HTTPS、代理、認證、超時控制、多請求並發)、性能最好、標準庫需安裝擴展、API 相對繁瑣生產環境首選、複雜 HTTP 交互
file_get_contents + stream_context無依賴、語法簡潔、原生支持 HTTPS/POST/Header無法精細控制超時(僅總超時)、無進度回調、錯誤處理弱簡單 GET/POST、快速腳本、禁用 cURL 環境
fsockopen 原始 Socket完全控制協議細節、無依賴、可實現非標準協議需手動構造 HTTP 協議、處理分塊編碼/Keep-Alive/SSL 极其繁瑣、易出錯教學、特殊協議、極度受限環境

封裝類:Request::post() 三種實現

<?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();
}

進階:cURL 並發請求 (curl_multi)

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;
}

最佳實踐建議

  1. 首選 cURL:功能完整、性能穩定、社區支持最好。
  2. 統一超時:設置 CURLOPT_CONNECTTIMEOUT (連接) 和 CURLOPT_TIMEOUT (總執行)。
  3. 錯誤處理:檢查 curl_errno()、HTTP 狀態碼 (curl_getinfo($ch, CURLINFO_HTTP_CODE))。
  4. SSL 驗證:生產環境**必須**開啟 CURLOPT_SSL_VERIFYPEER 並配置 CURLOPT_CAINFO。
  5. 重試策略:指數退避 + 幂等性保證 (GET/HEAD/PUT/DELETE 天然幂等,POST 需業務層去重)。

總結

掌握三種 POST 方式的優劣與適用邊界,封裝統一 Request 類,生產環境堅持 cURL + 完善異常處理 + 監控告警,是穩健 HTTP 客戶端的基石。

copyright © 萬盛學電腦網 all rights reserved