服务器
最后更新于：2022-04-02 07:06:24
## 服务器
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 常驻服务器 (仅限开发阶段使用)
';