必须手动启动主进程并验证进程树：PHP≥7.2且解除pcntl/posix禁用函数后，执行php start.php start -d，ps命令可见1个Master与3个Worker进程；kill任一Worker会自动拉起新进程，reload或USR1信号可平滑重载Worker而不中断连接。
要让 Workerman 4.0.41 真正跑起来并体现 Master-Worker 多进程模型的调度能力，必须手动启动主进程、观察子进程派生、验证信号控制逻辑——不能只写代码不看进程树，也不能跳过 PHP 环境权限校验直接运行。
确认 PHP 环境与禁用函数状态
打开终端，执行 php -v 确认版本 ≥7.2；再运行 php -r "print_r(get_defined_functions()['disabled']);" 查看禁用函数列表。
若输出中包含 pcntl_fork、pcntl_signal、posix_getpid 中任一函数，则必须修改 php.ini：找到 disable_functions 行，删掉这些函数名，然后重启 PHP-FPM 或 Web 服务。
【禁用函数未解除会导致 Worker 启动失败且无明确报错，进程直接退出】
创建基础 WebSocket 服务并启用多进程
新建 start.php，写入以下内容：
require_once __DIR__ . '/vendor/autoload.php';<br>use Workerman\Worker;<br>$ws = new Worker('websocket://0.0.0.0:8282');<br>$ws->count = 3;<br>$ws->name = 'ChatMaster';<br>$ws->onWorkerStart = function($worker) {<br> echo "Worker #{$worker->id} started\n";<br>};<br>Worker::runAll();
这一步设置了 3 个 Worker 子进程，但此时 Master 进程尚未显式声明——Workerman 会在 Worker::runAll() 内部自动 fork 出 Master，并由它统一管理这 3 个 Worker。
启动服务并验证 Master-Worker 进程结构
在项目根目录执行：php start.php start -d（加 -d 后台运行）。
立即执行 ps aux | grep -E '(start\.php|workerman)' | grep -v grep，你会看到类似输出：
www-data 12345 ... php start.php start -d<br>www-data 12346 ... php start.php start -d<br>www-data 12347 ... php start.php start -d<br>www-data 12348 ... php start.php start -d
其中 PID 最小的是 Master 进程（12345），其余三个是 Worker 子进程（12346–12348）。Master 不处理连接，只负责监听信号、重启异常 Worker、分发新连接。
尝试手动 kill 一个 Worker：kill 12347，2 秒后执行 ps 命令，会发现 PID 12347 消失，但出现一个新 PID（如 12352）——这就是 Master 自动拉起的新 Worker。
向 Worker 发送重载信号
方法一：命令行触发重载
执行 php start.php reload，所有 Worker 进程将被优雅终止并重新 fork。注意：这不是重启整个 Master，而是仅刷新 Worker 实例。
方法二：向 Master 进程发送 USR1 信号
先获取 Master PID：cat /tmp/workerman.start.pid（默认路径），再执行 kill -USR1 $(cat /tmp/workerman.start.pid)。
两种方式都会触发 $ws->onWorkerReload 回调（需提前定义），但不会中断正在处理的连接——这是 Master-Worker 架构保障平滑升级的关键机制。
停止服务并清理残留进程
第一步：执行 php start.php stop，Master 收到 TERM 信号后通知所有 Worker 退出，等待其自然结束。
第二步：若出现僵尸 Worker，执行 ps aux | grep start.php | awk '{print $2}' | xargs kill -9 强制清理。
第三步：删除 PID 文件：rm -f /tmp/workerman.start.pid，否则下次启动会报“端口已被占用”错误，即使实际没进程在监听。
