1. 安装依赖

composer require usualtool/ut-workerman

安装后即可用框架自带的 workerman 命令启动服务。

2. 代码职责

• ut-workerman/src/Events.php —— 负责所有业务逻辑，开发者在此进行逻辑处理。
• gatewayclient/Gateway.php —— 提供所有业务接口，通过 use GatewayClient\Gateway; 调用。

use GatewayClient\Gateway;
Gateway::sendToAll($msg);           // 广播
Gateway::sendToUid($uid, $msg);     // 定向推送

3. 端口规则

192.168.0.1:1025 → 自动注册服务 127.0.0.1:1025，并额外创建 WebSocket 服务 127.0.0.1:1026。

4. 命令速查

5. 默认启动

php usualtool workerman start 内网IP:端口
# 例：
php usualtool workerman start 192.168.0.1:1025

6. 守护启动

php usualtool workerman start -d 内网IP:端口
# 例：
php usualtool workerman start -d 192.168.0.1:1025

守护启动命令参数与默认启动一样，区别在于 start 后增加了参数 -d。

7. 停止进程

# 默认启动模式
Ctrl + C
php usualtool workerman stop
# 守护启动模式
php usualtool workerman stop 192.168.0.1:1025

8. 强制重启

php usualtool workerman restart 内网IP:端口
# 例：
php usualtool workerman restart 192.168.0.1:1025

9. 平滑重启

php usualtool workerman reload

服务在启动的情况下才能平滑重启，适用于只改业务代码（Events.php）的场景。

10. 查看状态

php usualtool workerman status