>[danger] 該組件為系統組件，在組件樹中只可命名為 registry，不可修改為其他名稱。 ## 注冊器 注冊器負責指定 URL 的由具體哪個 Handler 來執行，與 HTTP 的路由類似。 | 類 | 調用 | | --- | --- | | Mix\WebSocket\Registry | app()->registry | ## 依賴注入配置 [>> 到 GitHub 查看默認配置 <<](https://github.com/mix-php/mix/blob/v2/applications/websocket/config/main_coroutine.php#L160) ## 注冊規則 ``` // 注冊規則 'rules' => [ '/websocket' => ['WebSocketHandler', 'interceptor' => 'WebSocketInterceptor'], ], ``` 規則詳解： - `/websocket` 為綁定的 URL。 - `WebSocketHandler` 為處理器類名，與 `handlerNamespace` 參數組成完整的類路徑。 - `WebSocketInterceptor` 為攔截器類名，與 `interceptorNamespace` 參數組成完整的類路徑。 ## Handler 當 swoole_websocket_server 服務器觸發以下事件時，注冊器會調用處理器的以下方法： - `onOpen ` 事件調用 `open ` 方法，當配置中開啟 `enable_handshake` 時不觸發 [查看](https://github.com/mix-php/mix/blob/v2/applications/websocket/config/websocketd.php#L19)。 - `onMessage ` 事件調用 `message` 方法 - `onClose ` 事件調用 `close` 方法 [>> 到 GitHub 查看使用范例 <<](https://github.com/mix-php/mix/blob/v2/applications/websocket/src/Handlers/WebSocketHandler.php) ## Interceptor 當配置中開啟 `enable_handshake` 時 [查看](https://github.com/mix-php/mix/blob/v2/applications/websocket/config/websocketd.php#L19)，攔截器才會執行，攔截器負責 WebSocket 的握手處理。 當 swoole_websocket_server 服務器觸發以下事件時，注冊器會調用攔截器的以下方法： - `onHandshake ` 事件調用 `handshake` 方法 ### v13 握手 框架提供了攔截器基類，默認提供了 v13 的握手處理，用戶只需繼承即可使用： [>> 到 GitHub 查看使用范例 <<](https://github.com/mix-php/mix/blob/v2/applications/websocket/src/Interceptors/WebSocketInterceptor.php)