萬盛學電腦網

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

PHP 實作 WebSocket 伺服器完整教學:Socket 連線建立、握手協議與資料幀解析

WebSocket 提供全雙工長連線,PHP 雖無 Node.js 內建支援,但透過 Socket 擴充可完整實作。本文詳解 WebSocket 握手流程、Sec-WebSocket-Key 提取與加密、資料幀編解碼,並提供可運行的伺服器類別完整代碼。

WebSocket 協議核心流程

  1. Client 發起 HTTP Upgrade 請求,攜帶 Sec-WebSocket-Key
  2. Server 驗證並回應 101 Switching Protocols,回傳 Sec-WebSocket-Accept
  3. 雙方進入二進制幀協議,進行全雙工通訊

Client 握手請求範例

GET /chat HTTP/1.1
Host: server.example.com
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==
Origin: https://www.example.com
Sec-WebSocket-Protocol: chat, superchat
Sec-WebSocket-Version: 13

Server 端完整實作

<?php
class WebSocketServer {
    private $master;
    private $sockets = [];
    private $handshake = false;
    const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';

    public function __construct(string $address, int $port) {
        $this->master = socket_create(AF_INET, SOCK_STREAM, SOL_TCP)
            or die("socket_create failed");
        socket_set_option($this->master, SOL_SOCKET, SO_REUSEADDR, 1)
            or die("socket_option failed");
        socket_bind($this->master, $address, $port)
            or die("socket_bind failed");
        socket_listen($this->master, 2)
            or die("socket_listen failed");
        
        $this->sockets[] = $this->master;
        echo "Master socket: {$this->master}\n";
        $this->run();
    }

    private function run(): void {
        while (true) {
            $read = $this->sockets;
            $write = $except = null;
            socket_select($read, $write, $except, null);

            foreach ($read as $socket) {
                if ($socket === $this->master) {
                    $this->acceptClient();
                } else {
                    $this->handleClient($socket);
                }
            }
        }
    }

    private function acceptClient(): void {
        $client = socket_accept($this->master);
        if ($client < 0) {
            echo "socket_accept failed\n";
            return;
        }
        $this->sockets[] = $client;
        echo "Client connected\n";
    }

    private function handleClient($socket): void {
        $bytes = @socket_recv($socket, $buffer, 2048, 0);
        if ($bytes === 0 || $bytes === false) {
            $this->closeClient($socket);
            return;
        }

        if (!$this->handshake) {
            $this->doHandshake($socket, $buffer);
        } else {
            $data = $this->decode($buffer);
            $this->process($socket, $data);
        }
    }

    private function doHandshake($socket, string $request): void {
        $key = $this->extractKey($request);
        if (!$key) {
            $this->closeClient($socket);
            return;
        }
        
        $accept = base64_encode(sha1($key . self::GUID, true));
        $response = "HTTP/1.1 101 Switching Protocols\r\n"
                  . "Upgrade: websocket\r\n"
                  . "Connection: Upgrade\r\n"
                  . "Sec-WebSocket-Accept: $accept\r\n\r\n";
        
        socket_write($socket, $response, strlen($response));
        $this->handshake = true;
        echo "Handshake done\n";
    }

    private function extractKey(string $request): ?string {
        if (preg_match('/Sec-WebSocket-Key:\s*(.+)\r\n/', $request, $match)) {
            return trim($match[1]);
        }
        return null;
    }

    private function decode(string $buffer): string {
        $len = ord($buffer[1]) & 127;
        $offset = 2;
        if ($len === 126) {
            $offset = 4;
        } elseif ($len === 127) {
            $offset = 10;
        }
        $mask = substr($buffer, $offset, 4);
        $data = substr($buffer, $offset + 4);
        $decoded = '';
        for ($i = 0; $i < strlen($data); $i++) {
            $decoded .= $data[$i] ^ $mask[$i % 4];
        }
        return $decoded;
    }

    private function encode(string $data): string {
        $frame = [0x81]; // FIN=1, OPCODE=1 (text)
        $len = strlen($data);
        if ($len <= 125) $frame[] = $len;
        elseif ($len <= 65535) $frame = array_merge($frame, [126, $len >> 8, $len & 0xFF]);
        else $frame = array_merge($frame, [127, 0,0,0,0, $len >> 24, $len >> 16, $len >> 8, $len & 0xFF]);
        return implode(array_map('chr', $frame)) . $data;
    }

    private function process($socket, string $data): void {
        echo "Received: $data\n";
        // 回聲測試
        $response = $this->encode("Server echo: $data");
        socket_write($socket, $response, strlen($response));
    }

    private function closeClient($socket): void {
        $index = array_search($socket, $this->sockets, true);
        if ($index !== false) unset($this->sockets[$index]);
        socket_close($socket);
        echo "Client disconnected\n";
    }
}

// 啟動伺服器
$server = new WebSocketServer('0.0.0.0', 4000);
?>

Client 端測試代碼 (JavaScript)

<script>
const ws = new WebSocket("ws://localhost:4000");
ws.onopen = () => console.log("握手成功");
ws.onmessage = (e) => console.log("收到:", e.data);
ws.onerror = (e) => console.error("錯誤:", e);
ws.onclose = () => console.log("連線關閉");

// 發送測試
setTimeout(() => ws.send("Hello from JS"), 1000);
</script>

關鍵技術點總結

環節關鍵點
Socket 建立AF_INET + SOCK_STREAM + SOL_TCP,SO_REUSEADDR 避免 TIME_WAIT
多路複用socket_select() 監聽讀/寫/異常事件
握手驗證SHA1(key + GUID) → Base64 → Sec-WebSocket-Accept
幀解碼掩碼 XOR 解碼,支援 125/126/127 三種長度編碼
幀編碼FIN=1, OPCODE=1(text), 長度編碼,無掩碼(Server→Client)

生產環境建議

  • 使用 ReactPHP/Ratchet/Swoole 成熟框架,勿手寫生產級 Server
  • 啟用 wss:// (TLS) 加密傳輸
  • 實現心跳機制 (Ping/Pong) 偵測斷線
  • 處理大訊息分片、重組邏輯
  • 加入連線數限制、速率限制、來源驗證

理解 WebSocket 底層協議細節,有助於排查連線問題、客製化協議擴充、選型技術棧。以上代碼為教學級實作,生產請採用成熟庫。

copyright © 萬盛學電腦網 all rights reserved