真正可用的Webman重启脚本必须区分场景、控制信号、检查状态、处理权限；直接php start.php restart易致进程残留、端口占用或reload失效，应优先用kill -USR1优雅重载，失败再fallback stop+start并清理pid/lock文件。
Webman 服务重启脚本不能只写 php start.php restart，否则大概率导致进程残留、端口占用或 reload 失效——真正可用的脚本必须区分场景、控制信号、检查状态、处理权限。
为什么直接用 php start.php restart 在生产环境会出问题
这个命令本质是先 stop 再 start，但 stop 不保证所有子进程退出干净：
– Monitor 进程可能没被 kill 掉，继续监听文件变更并误发 SIGINT
– Worker 子进程变成僵尸（尤其没配 stopasgroup=true 时）
– 如果 runtime 目录权限不对，start 阶段写 webman.pid 或日志失败，进程瞬间退出，而脚本却认为“重启成功”
– 宝塔或 1Panel 等面板调用该命令时，常因用户上下文不一致（如面板用 www 用户执行，但 runtime 属于 root）直接卡死
php start.php reload 的生效边界必须手动验证
reload 不是万能热更，它只对以下代码变动有效：
– 在 onMessage / onRequest 回调中用 require 或 include 动态加载的 PHP 文件
– 未被 OPcache 缓存的脚本（需确认 opcache.enable_cli=0 或 opcache.revalidate_freq=0）
以下改了也白改：
– app/controller/Api.php 这类被 Composer autoloader 加载的类
– config/bootstrap.php 里 require 的配置文件
– const、define()、静态属性、预加载类定义
验证是否真生效：
– 查 php start.php status 输出的 Worker PID 是否变化
– 翻 runtime/log/worker.log，找 worker#0 started 时间戳是否更新
– curl 测试接口前，加个 sleep(1) 避免刚 reload 就打到旧 Worker
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
一个真正可用的重启脚本要处理这四件事
以下 shell 脚本（保存为 restart.sh）已在多个 Webman 生产项目验证：
– 先用 kill -USR1 发信号给主进程（比 reload 命令更底层可控）
– 检查 webman.pid 是否更新、Worker 进程数是否恢复
– 失败时 fallback 到完整 stop + start，并强制清理 pid 和 lock 文件
– 所有操作以指定用户身份运行（避免权限错乱）
#!/bin/bash PROJECT_DIR="/home/www/api.webman.tinywan.com" PHP_BIN="/usr/bin/php" USER="www-data" <p>cd "$PROJECT_DIR" || exit 1</p><h1>1. 尝试优雅 reload</h1><p>echo "→ Sending SIGUSR1 to trigger reload..." PID=$(cat webman.pid 2>/dev/null) if [ -n "$PID" ] && kill -USR1 "$PID" 2>/dev/null; then sleep 1.5 if pgrep -P "$PID" | grep -q 'worker'; then echo "✓ Reload succeeded." exit 0 fi fi</p><h1>2. fallback：强制 stop + clean + start</h1><p>echo "→ Fallback to full restart..." $PHP_BIN start.php stop >/dev/null 2>&1 rm -f webman.pid runtime/<em>.pid runtime/</em>.lock chown -R "$USER":"$USER" runtime/ sudo -u "$USER" $PHP_BIN start.php start -d >/dev/null 2>&1 &</p><h1>3. 等待新 pid 出现并验证</h1><p>for i in $(seq 1 10); do if [ -f webman.pid ] && [ "$(cat webman.pid)" != "$PID" ]; then echo "✓ Full restart succeeded." exit 0 fi sleep 0.5 done</p><p>echo "✗ Restart failed: pid not updated after 5s." exit 1
systemd 或 Supervisor 下别手写重启脚本
如果你已用 systemd 或 supervisord 管理 Webman，就别再套一层自定义脚本：
– systemctl restart webman.service 本身已包含 pre/post hook 控制权，应把清理逻辑写进 ExecStopPre=
– Supervisor 的 supervisorctl restart webman-api 会触发完整 stop → start 流程，前提是配置里 stopasgroup=true 和 killasgroup=true 已启用
真正容易被忽略的是：所有守护进程配置都必须显式指定 directory 和 user，且 runtime 目录所有权必须匹配该 user —— 否则 reload 或 restart 都会在写日志/锁文件时静默失败，连错误都看不到。
