Webman中如何实现平滑重启不中断业务-php教程-PHP中文网

php start.php reload 只重载 Worker 进程内动态 require 的文件，如 onMessage 中引入的业务逻辑；不重载 Composer 自动加载类、配置文件、const/define/静态属性、OPcache 缓存代码等已驻留内存的内容。

webman中如何实现平滑重启不中断业务

php start.php reload 能做到不中断业务，但前提是代码加载方式、OPcache 和进程生命周期都符合它的作用边界——它只重载 Worker 进程内动态 require 的文件，其余一概不管。

Webman 的 php start.php reload 本质是向主进程发 SIGUSR1，触发 Worker 进程逐个退出并重启。但它只对以下内容生效：

在 onMessage、onRequest 等回调里用 require 或 include 动态引入的 PHP 文件（比如路由分发后加载的 controller）
Worker 进程运行时重新解析的逻辑（前提是没被 OPcache 缓存或类定义已加载）

它完全不触碰这些：

onWorkerStart 中一次性 require 的配置或类
const、define()、静态属性、类定义等已加载进内存的符号
OPcache 缓存的字节码（尤其当 opcache.enable_cli=1 时）
通过 Composer autoloader 加载的控制器（如 app/controller/Api.php），因为 autoload 是全局注册、一次加载终身有效

典型现象：你改了 app/controller/Api.php，执行 php start.php reload，curl 却仍返回旧值。这不是命令失败，而是加载路径根本没走 reload 覆盖范围。

Webman 2.2.0

Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。

下载

确认控制器是否被动态 require：Webman 默认走 Composer autoload，而 autoload 类不会因 reload 重新加载
临时验证：加 -d opcache.enable_cli=0 再 reload，比如 php -d opcache.enable_cli=0 start.php reload；若此时生效，说明是 OPcache 搞的鬼
检查有没有在 config/bootstrap.php 或 webman\support\Bootstrap 中提前 require 了业务类——这些都在 Worker 初始化阶段完成，reload 不会重跑
别只信终端输出的 “Reload success”：查 php start.php status 输出的 Worker PID 是否变化，或翻 runtime/log/worker.log 看是否有新 worker#0 started 记录

想让 reload 生效，就得把变更控制在它的“作用域”里：

把需要热更的逻辑抽出来，放在单独文件中，并在 onMessage 或 onRequest 回调里用 require 动态加载（注意路径和变量作用域）
禁用 CLI 模式下的 OPcache：opcache.enable_cli=0，或设 opcache.revalidate_freq=0（开发环境可接受，生产慎用）
定时任务更新必须 reload：改了 app/process/Task.php 后，php start.php reload 才能刷新 Crontab 实例；restart 会中断任务
WebSocket 或 TCP 自定义进程也受 reload 影响，但前提是它们的业务逻辑同样走动态加载，而非在 onWorkerStart 里写死