## 服务器 WebSocket 是基于 HTTP 之上实现的协议,因此 WebSocket 也同样是使用的 HttpServer::class 然后通过 Upgrader::class 把连接升级为 WebSocket 长连接。 ## 启动 启动服务器: ~~~ php bin/mix.php ws:start ~~~ 以上命令的各部分拆解如下: - `bin/mix.php` 为入口文件 - `ws:start` 为命令 查看帮助: ~~~ php bin/mix.php ws:start --help ~~~ `ws:start` 包含以下可选参数: - `-d, --daemon` 程序在后台执行 - `-h, --host` 指定服务器 IP - `-p, --port` 指定服务器端口 - `-r, --reuse-port ` 端口复用,用于多开利用多核 ## 入口代码 从 `manifest.php` 的 `commands` 或者 `commandPath` 配置我们能看到 `ws:start` 命令启动的是: [>> \App\WebSocket\Commands\StartCommand::class <<](https://github.com/mix-php/mix-skeleton/tree/v2.1/app/WebSocket/Commands/StartCommand.php) >[success] 服务器代码都写在 StartCommand::class 中,用户能最大粒度的修改每一处服务器的执行细节 - StartCommand::class 属性 `$patterns` 记录了注册的 URL 与对应的处理器。 - 通过 `$this->handle` 方法将 [$patterns](https://github.com/mix-php/mix-skeleton/tree/v2.1/app/WebSocket/Commands/StartCommand.php#L35) 设定的 `/websocket` 升级为 WebScoket 连接,并使用 [WebSocketHandler::class](https://github.com/mix-php/mix-skeleton/tree/v2.1/app/WebSocket/Handlers/WebSocketHandler.php) 来处理连接。 - WebSocketHandler::class 中采用 JSON-RPC 2.0 交互规范。 - WebSocketHandler::class 属性 `$methods` 记录了支持的 RPC method 与对应的控制器。 - WebSocketHandler::class 将注册的消息 `join.room`、`message.emit` 转发到 JoinController::class、MessageController::class 处理。 ## 命令管理 与 mix 之前版本不同的是,新版只提供了 start 命令,这是因为新版 mix 是单进程协程框架,因为是单进程所以可以直接通过 kill 停止执行,停止是平滑安全的这一点能在 StartCommand::class 的源码中看到实现逻辑: ``` // 查找名为 mix 的进程 $> ps -ef | grep mix // kill指定pid $> kill [PID] ``` ## 热更新 (仅限开发阶段使用) 为了提升开发效率,我们提供了 [https://github.com/mix-php/swoolefor](https://github.com/mix-php/swoolefor) 工具,能监控文件系统变化,通过设置的命令自动重启服务器,可用于修改代码后自动重启各种 Swoole 常驻服务器 (仅限开发阶段使用)