WebSocket 提供全雙工長連線,PHP 雖無 Node.js 內建支援,但透過 Socket 擴充可完整實作。本文詳解 WebSocket 握手流程、Sec-WebSocket-Key 提取與加密、資料幀編解碼,並提供可運行的伺服器類別完整代碼。
Sec-WebSocket-KeySec-WebSocket-AcceptGET /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
<?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);
?>
<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) |
wss:// (TLS) 加密傳輸理解 WebSocket 底層協議細節,有助於排查連線問題、客製化協議擴充、選型技術棧。以上代碼為教學級實作,生產請採用成熟庫。