>[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 上传文件失败
- 开发工具
- 版本更新
- 不兼容改动
- 升级指南
- 文档历史