PHP Socket 模擬 POST 請求完整實作：fsockopen、HTTP 協議組裝、檔案上傳、錯誤處理與 cURL 對比

PHP fsockopen() 底層建立 TCP 連線，手動組裝 HTTP 請求報文，可實作 POST 表單提交、JSON API 呼叫、multipart 檔案上傳。本文提供完整封裝函式、檔案上傳範例、錯誤處理、超時控制、與 cURL 對比優缺點，助你理解 HTTP 協議本質。

核心函式：fsockopen 參數詳解

$fp = fsockopen(
    string $hostname,    // 目標主機 (域名或 IP)
    int $port = -1,      // 連接埠 (HTTP=80, HTTPS=443)
    int &$errno = null,  // 錯誤碼引用
    string &$errstr = null, // 錯誤訊息引用
    float $timeout = ini_get('default_socket_timeout') // 連線超時秒數
): resource|false;

• 回傳資源控制代碼 (resource)，後續用 fwrite()/fread()/fclose() 操作
• HTTPS 需用 ssl://hostname 或 tls://hostname 作為 $hostname，port 443

封裝函式：socket_post() 通用 POST

<?php
/**
 * Socket 模擬 POST 請求
 * @param string $url 完整 URL (含 scheme://host/path?query)
 * @param array $data POST 欄位陣列 ['key'=>'val']
 * @param string $referer Referer 標頭
 * @return array ['status'=>'ok'|'error', 'header'=>'', 'content'=>'', 'error'=>'']
 */
function socket_post(string $url, array $data, string $referer = ''): array {
    if (!function_exists('fsockopen')) return ['status'=>'error', 'error'=>'fsockopen 不存在'];
    
    $parsed = parse_url($url);
    if (($parsed['scheme'] ?? '') !== 'http') return ['status'=>'error', 'error'=>'僅支援 HTTP'];
    
    $host = $parsed['host'];
    $path = $parsed['path'] ?? '/';
    if ($parsed['query'] ?? '') $path .= '?' . $parsed['query'];
    $port = $parsed['port'] ?? 80;
    
    $postData = http_build_query($data); // 自動 urlencode
    $contentLength = strlen($postData);
    
    // 組裝 HTTP 請求報文 (注意 \r\n 換行)
    $request = "POST $path HTTP/1.1\r\n";
    $request .= "Host: $host\r\n";
    $request .= "User-Agent: PHP-Socket/1.0\r\n";
    $request .= "Accept: */*\r\n";
    $request .= "Referer: $referer\r\n";
    $request .= "Content-Type: application/x-www-form-urlencoded\r\n";
    $request .= "Content-Length: $contentLength\r\n";
    $request .= "Connection: Close\r\n\r\n";
    $request .= $postData;
    
    $fp = @fsockopen($host, $port, $errno, $errstr, 10); // 10秒連線超時
    if (!$fp) return ['status'=>'error', 'error'=>"$errstr ($errno)"];
    
    // 設定讀寫超時 (需 PHP 4.3+)
    stream_set_timeout($fp, 10);
    
    fwrite($fp, $request);
    
    $response = '';
    while (!feof($fp)) {
        $response .= fread($fp, 4096);
    }
    fclose($fp);
    
    // 簡易分離 Header 與 Body
    list($header, $body) = explode("\r\n\r\n", $response, 2) + ['', ''];
    
    return [
        'status' => 'ok',
        'header' => $header,
        'content' => $body,
    ];
}

// 使用範例
$result = socket_post('https://httpbin.org/post', ['name'=>'test', 'value'=>123]);
echo $result['content'];
?>

檔案上傳：multipart/form-data 組裝

<?php
function socket_upload(string $url, string $filePath, string $fieldName = 'file', array $extraFields = []): array {
    $parsed = parse_url($url);
    $host = $parsed['host'];
    $path = $parsed['path'] ?? '/';
    $port = $parsed['port'] ?? 80;
    
    $boundary = '----PHP_SOCKET_' . md5(microtime());
    $body = '';
    
    // 額外欄位
    foreach ($extraFields as $key => $val) {
        $body .= "--$boundary\r\n";
        $body .= "Content-Disposition: form-data; name=\"$key\"\r\n\r\n";
        $body .= "$val\r\n";
    }
    
    // 檔案欄位
    $fileName = basename($filePath);
    $mimeType = mime_content_type($filePath) ?: 'application/octet-stream';
    $fileContent = file_get_contents($filePath);
    
    $body .= "--$boundary\r\n";
    $body .= "Content-Disposition: form-data; name=\"$fieldName\"; filename=\"$fileName\"\r\n";
    $body .= "Content-Type: $mimeType\r\n\r\n";
    $body .= $fileContent . "\r\n";
    $body .= "--$boundary--\r\n";
    
    $request = "POST $path HTTP/1.1\r\n";
    $request .= "Host: $host\r\n";
    $request .= "Content-Type: multipart/form-data; boundary=$boundary\r\n";
    $request .= "Content-Length: " . strlen($body) . "\r\n";
    $request .= "Connection: Close\r\n\r\n";
    $request .= $body;
    
    $fp = @fsockopen($host, $port, $errno, $errstr, 30);
    if (!$fp) return ['status'=>'error', 'error'=>"$errstr ($errno)"];
    stream_set_timeout($fp, 30);
    fwrite($fp, $request);
    $response = '';
    while (!feof($fp)) $response .= fread($fp, 8192);
    fclose($fp);
    list($header, $content) = explode("\r\n\r\n", $response, 2) + ['', ''];
    return compact('status', 'header', 'content') + ['status'=>'ok'];
}

// 使用
$result = socket_upload('https://example.com/upload', '/path/to/image.jpg', 'avatar', ['user_id'=>123]);

關鍵細節與避坑

Socket vs cURL 對比

總結建議

1. 生產環境請直接使用 cURL (或 Guzzle/HttpClient)，除非極度受限環境。
2. 學習 HTTP 協議、教學示範、嵌入式裝置無 cURL 時，Socket 手動組裝有教學價值。
3. 若必須用 Socket，務必處理：超時 (stream_set_timeout)、錯誤碼、HTTPS、大檔案分塊、重導向、Chunked 回應、Keep-Alive。
4. 封裝通用函式/類別，統一錯誤處理、日誌、重試邏輯。

相關專題：《PHP 網絡編程技巧總結》、《PHP Socket 用法總結》。