PHP-PM代码不生效需启用--reload参数并配置opcache；ppm restart失败应清理socket文件并检查权限；零停机更新需nginx配合graceful shutdown及正确upstream配置。
PHP-PM 启动后代码不生效？检查 reload 机制是否启用
PHP-PM 默认启动后不会自动监听文件变化，改完代码必须手动触发重载，否则永远跑的是旧版本。它不是 Laravel Mix 那种开箱即热更的工具。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 启动时加
--reload参数才能开启文件监控（仅开发环境推荐，生产慎用） - 生产环境应禁用自动 reload，改用显式
ppm restart或ppm signal --signal=reload -
--watch和--reload不是同一回事：--watch只触发进程重启，--reload才真正做代码热加载（依赖 opcache 配置） - 确认
opcache.enable和opcache.validate_timestamps在 PHP 配置中已开启，否则即使 reload 也看不到新代码
ppm restart 报错 “Connection refused”？检查 socket 文件权限和生命周期
执行 ppm restart 失败，常见于 socket 文件残留或权限错乱，尤其在非 root 用户下反复启停后。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先运行
ppm status确认当前 master 进程 PID，再查ps aux | grep ppm验证是否真在运行 - 若 master 已死但
/tmp/ppm-{app-name}.sock还在，手动删掉该<code>/tmp/ppm-*.sock - 确保
ppm.json中"socket_path"指向的目录对运行用户可读写；默认/tmp通常没问题，但容器或严格权限环境需显式指定 - 避免在 CI/CD 脚本里直接
ppm restart：它可能因超时失败却不报错，改用ppm stop && ppm start更可控
零停机更新失败？关键在 nginx 的 upstream 切换时机和 ppm 的 graceful shutdown
所谓“零停机”，本质是让 nginx 把新请求导向新 worker，同时让旧 worker 处理完剩余请求再退出。PHP-PM 本身支持 graceful shutdown，但需要配合 nginx 配置。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- nginx upstream 必须配置
max_fails=0和fail_timeout=0，否则 reload 期间探测失败会踢出 server - PHP-PM 启动时加上
--workers=4（别用默认 8），避免单次 reload 触发过多进程震荡 - 更新前先
ppm signal --signal=graceful-stop等待所有 worker 自然退出，再ppm start；比强制restart更稳妥 - 注意：PHP-PM 的 graceful 仅保证正在处理的请求完成，不保证队列中的 FastCGI 请求不丢——所以 nginx 层要配好
proxy_next_upstream
opcache 配置不对，热更就形同虚设
PHP-PM 的 reload 依赖 opcache 刷新脚本，如果 opcache 缓存了太久，或者没校验时间戳，新代码根本不会被加载。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认 php.ini 中有：
opcache.enable=1、opcache.validate_timestamps=1、opcache.revalidate_freq=0（生产可设为 2，但不能为 0 以外的整数且无 reload 机制时无效） - 不要在代码里调用
opcache_invalidate()或opcache_reset()：PHP-PM 内部已封装，手动调用反而可能破坏状态 - 用
php -i | grep opcache核对实际生效的配置项，Docker 或多 PHP 版本环境常因 ini 加载顺序导致配置未生效
最常被忽略的一点：PHP-PM 的 reload 不等于“所有全局变量重置”，static 属性、global 变量、PDO 连接池里的连接对象，都不会被清空。如果你的代码靠这些维持状态，热更后行为可能和预期不一致。
