在使用 workerman 開發 websocket 服務器時，握手失敗的原因主要包括請求頭不正確、sec-websocket-key 處理錯誤、狀態碼錯誤和子協議及擴展處理錯誤。1) 請求頭不正確時，檢查客戶端的請求頭；2) sec-websocket-key 處理錯誤時，通過日志記錄相關值來調試；3) 狀態碼錯誤時，檢查服務器返回的 http 狀態碼；4) 子協議和擴展處理錯誤時，記錄處理過程來調試。
引言
在開發 WebSocket 服務器時，握手失敗是一個常見的問題，搞得我頭疼了好幾天。今天就來聊聊在使用 workerman 開發 WebSocket 服務器時，握手失敗的那些事兒。讀完這篇文章，你將了解到握手失敗的各種原因，以及如何避免這些問題，讓你的 WebSocket 服務器更加穩定可靠。
基礎知識回顧
WebSocket 是一種在單個 TCP 連接上進行全雙工通信的協議，它通過一個 HTTP 握手過程來建立連接。Workerman 是一個高性能的 php 框架，非常適合開發 WebSocket 服務器。在使用 Workerman 時，握手過程是通過 HTTP 請求和響應來完成的，如果這個過程出現問題，就會導致握手失敗。
Workerman 提供了 onWebSocketConnect 回調函數來處理 WebSocket 連接的握手過程，這個函數是我們需要重點關注的地方。
核心概念或功能解析
WebSocket 握手過程的定義與作用
WebSocket 握手過程是客戶端和服務器之間建立 WebSocket 連接的關鍵步驟。這個過程通過 HTTP 請求和響應來完成，客戶端發送一個特殊的 HTTP 請求，服務器返回一個 HTTP 響應，如果一切正常，連接就會升級為 WebSocket 連接。
握手過程的作用是確?？蛻舳撕头掌鞫贾С?WebSocket 協議，并且能夠協商出合適的子協議和擴展。
public function onWebSocketConnect($connection, $http_response) { // 握手處理邏輯 }
工作原理
在 Workerman 中，握手過程主要通過 onWebSocketConnect 函數來處理。這個函數會在客戶端發送 WebSocket 握手請求時被調用，服務器需要在這個函數中驗證請求頭，生成正確的響應頭，并通過 $http_response 對象返回給客戶端。
握手過程的關鍵步驟包括：
- 驗證客戶端請求頭中的 Upgrade 和 Connection 字段，確保它們分別為 websocket 和 Upgrade。
- 驗證 Sec-WebSocket-Key 字段，并生成 Sec-WebSocket-Accept 響應頭。
- 設置 HTTP 狀態碼為 101 switching Protocols，并返回正確的響應頭。
如果這些步驟中的任何一個出現問題，都會導致握手失敗。
使用示例
基本用法
下面是一個簡單的 Workerman WebSocket 服務器握手處理示例：
use WorkermanWorker; use WorkermanConnectionTcpConnection; $worker = new Worker('websocket://0.0.0.0:8080'); $worker->onWebSocketConnect = function($connection, $http_response) { $connection->onWebSocketConnect = function($connection, $http_response) { $secWebSocketKey = $connection->header('Sec-WebSocket-Key'); $secWebSocketAccept = base64_encode(sha1($secWebSocketKey . '258EAFA5-E914-47DA-95CA-C5AB0DC85B11', true)); $http_response->withHeader('Sec-WebSocket-Accept', $secWebSocketAccept); $http_response->withHeader('Upgrade', 'websocket'); $http_response->withHeader('Connection', 'Upgrade'); $http_response->withStatus(101); }; }; Worker::runAll();
這段代碼展示了如何在 onWebSocketConnect 函數中處理 WebSocket 握手請求，生成正確的響應頭，并返回給客戶端。
高級用法
在實際開發中，我們可能需要處理更多的握手細節，比如支持子協議和擴展。這里是一個支持子協議的示例：
$worker->onWebSocketConnect = function($connection, $http_response) { $secWebSocketKey = $connection->header('Sec-WebSocket-Key'); $secWebSocketAccept = base64_encode(sha1($secWebSocketKey . '258EAFA5-E914-47DA-95CA-C5AB0DC85B11', true)); $http_response->withHeader('Sec-WebSocket-Accept', $secWebSocketAccept); $http_response->withHeader('Upgrade', 'websocket'); $http_response->withHeader('Connection', 'Upgrade'); // 處理子協議 $protocols = $connection->header('Sec-WebSocket-Protocol'); if ($protocols) { $protocols = explode(',', $protocols); $protocol = trim($protocols[0]); $http_response->withHeader('Sec-WebSocket-Protocol', $protocol); } $http_response->withStatus(101); };
這個示例展示了如何在握手過程中處理子協議，確?？蛻舳撕头掌髂軌騾f商出合適的子協議。
常見錯誤與調試技巧
握手失敗的原因有很多，以下是一些常見的錯誤和調試技巧：
-
請求頭不正確：客戶端發送的請求頭中 Upgrade 和 Connection 字段必須分別為 websocket 和 Upgrade，否則服務器會拒絕握手請求。可以通過檢查客戶端的請求頭來排查這個問題。
-
Sec-WebSocket-Key 處理錯誤：服務器需要正確處理 Sec-WebSocket-Key 字段，并生成正確的 Sec-WebSocket-Accept 響應頭。如果這個過程出錯，握手就會失敗。可以通過日志記錄 Sec-WebSocket-Key 和 Sec-WebSocket-Accept 的值來調試。
-
狀態碼錯誤：握手響應的狀態碼必須為 101 Switching Protocols，如果狀態碼不正確，握手也會失敗。可以通過檢查服務器返回的 HTTP 狀態碼來排查這個問題。
-
子協議和擴展處理錯誤：如果客戶端請求中包含子協議或擴展，服務器需要正確處理這些字段，否則握手可能會失敗?？梢酝ㄟ^日志記錄子協議和擴展的處理過程來調試。
性能優化與最佳實踐
在開發 WebSocket 服務器時，握手過程的性能優化和最佳實踐非常重要。以下是一些建議：
-
緩存 Sec-WebSocket-Accept：生成 Sec-WebSocket-Accept 是一個計算密集的過程，可以考慮將結果緩存起來，避免每次握手都重新計算。
-
使用異步處理：Workerman 支持異步處理，可以利用這個特性來提高握手過程的性能，避免阻塞。
-
日志記錄和監控：在握手過程中記錄詳細的日志，可以幫助快速定位和解決問題。同時，監控握手失敗的頻率和原因，可以幫助優化服務器的性能。
-
代碼可讀性和維護性：在編寫握手處理代碼時，注意代碼的可讀性和維護性，適當添加注釋和文檔，方便后續的維護和調試。
總之，握手失敗的原因多種多樣，理解握手過程的工作原理和常見錯誤，可以幫助我們更好地開發和優化 WebSocket 服務器。希望這篇文章能對你有所幫助，讓你的 WebSocket 服務器更加穩定可靠。
