>[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)
- 歡迎使用 MixPHP
- 安裝說明
- 全量安裝
- Phar 命令行
- 入門須知
- 增改應用
- 命名空間
- 自動加載
- 入口文件
- 配置文件
- 服務開發
- 核心基礎
- Bean
- Component
- Application
- 命令行
- 簡介
- 命令行開發常識
- 命令行開發
- 創建命令
- 命令參數
- 打印與顏色
- 控制臺程序
- 守護程序
- HTTP 服務
- 簡介
- 服務器
- 路由
- 請求
- 響應
- 控制器
- 視圖
- Auth
- Session
- 文件上傳
- 其他組件
- 分頁
- 驗證碼
- 圖片處理
- 客戶端
- GuzzleHttp
- 雜項
- Apache/PHP-FPM部署
- 調試與錯誤
- 安全建議
- WebSocket 服務
- 簡介
- 服務器
- 注冊器
- 連接
- 客戶端
- 測試
- 雜項
- nginx代理
- 60s無消息斷線
- TCP 服務
- 簡介
- 服務器
- 客戶端
- 測試
- UDP 服務
- 簡介
- 服務器
- 客戶端
- 測試
- 協程
- 簡介
- 開啟協程
- PHP Stream Hook
- xgo + Channel
- WaitGroup + xdefer
- 連接池
- 協程池
- 定時器
- 公共組件
- 中間件
- 驗證器
- 驗證器定義
- 驗證規則
- 靜態調用
- 模型
- 日志
- 緩存
- 數據庫
- Database
- QueryBuilder
- PDOConnection
- Persistent\PDOConnection
- Coroutine\PDOConnection
- MasterSlave\PDOConnection
- ExecuteListener
- Redis
- RedisConnection
- Persistent\RedisConnection
- Coroutine\RedisConnection
- ExecuteListener
- 常見問題
- 同一臺服務器部署多個服務
- 連接多個數據庫
- 如何設置跨域
- form-data 上傳文件失敗
- 開發工具
- 版本更新
- 不兼容改動
- 升級指南
- 文檔歷史