FrankenPHP 不支持传统平滑重启，其 reload 仅触发 Caddy 配置热重载，不更新 PHP 代码；worker 模式下需手动 kill -TERM 或启用 watch: true 并配合 opcache_reset() 才能使 Symfony 新代码生效。
FrankenPHP 本身不支持传统意义的“平滑重启”——它没有 reload 命令，也没有类似 Workerman 的 SIGUSR1 子进程轮换机制；所谓“不中断请求”，必须靠 Caddy 的零停机重载 + PHP worker 进程的优雅退出协同实现，且仅对开启 worker 模式的 Symfony 应用有效。
FrankenPHP 的 reload 实际触发的是 Caddy 配置热重载，不是 PHP 代码重载
FrankenPHP 启动后，本质是 Caddy 进程托管了 PHP 运行时。当你执行 caddy reload（或通过 frankenphp reload 封装命令），真正发生的是：
- Caddy 重新解析
Caddyfile，替换监听地址、TLS 设置、路由规则等 —— 这部分可零中断 - 但 PHP worker 进程不会被主动 kill 或替换，旧的 worker 仍持有 Symfony 容器、缓存、数据库连接等状态
- 新请求是否走新逻辑，取决于路由是否变更；但已建立的长连接（如 SSE、WebSocket）或正在处理的请求，仍由原 worker 执行完为止
- 如果你改了 Symfony 的控制器、服务定义或配置文件，这些变更在 worker 常驻期间根本不会生效
Symfony 在 FrankenPHP worker 模式下如何“感知”代码变更
worker 模式让 Symfony 应用启动一次、常驻内存，省掉每次请求的 bootstrap 开销，但代价是：它默认不自动检测文件变更。要让新代码生效，必须让 worker 主动退出并由 Caddy 拉起新实例。可行路径只有两个：
- 在
frankenphp.yaml中启用watch: true（需 FrankenPHP ≥ 1.2），它会监听项目目录内.php、.yaml、.env等文件变化，并向当前 worker 发送SIGTERM - 手动调用
kill -TERM $PID杀掉 worker 进程（Caddy 会自动拉起新 worker，前提是startup: 1或未设限） - 注意：
watch不监控 vendor 目录，也不触发 OPcache 清理；若你更新了 Composer 包，仍需手动opcache_reset()或重启整个 FrankenPHP 进程
为什么直接改 Symfony 配置后 reload 没反应？三个典型卡点
常见现象：改完 config/packages/cache.yaml，执行 caddy reload，日志里没报错，但缓存行为还是旧的。原因往往在这几个地方：
立即学习“PHP免费学习笔记（深入）”；
- Symfony 缓存已编译（
var/cache/prod/下的 PHP 文件），worker 进程加载的是缓存后的类，不是原始 YAML —— 改 YAML 不等于改运行时行为 - FrankenPHP 的 PHP 运行时默认启用了 OPcache，且
opcache.validate_timestamps=0（CLI 模式下尤其常见），导致即使文件变了，字节码也不会重编译 - worker 进程内使用了静态属性或单例（如
static $container），reload/Caddy 重载不触发进程重建，旧实例继续服务
解决办法不是 reload，而是：删 var/cache/* + 在 onWorkerStart 回调中加 opcache_reset()（FrankenPHP 支持该钩子）+ 用 kill -TERM 触发 worker 重启。
别依赖 “reload” 做业务发布，用进程管理 + 版本化部署更可靠
FrankenPHP 的设计哲学是“轻量 Web 服务器 + 可控 PHP 生命周期”，不是“热更新平台”。线上做 Symfony 业务发布时，真正安全的做法是：
- 把 Symfony 应用打包成独立目录（含
vendor、var/cache预编译好），用软链接切换current → release-20261004 - 新版本启动前，先
kill -TERM当前所有 worker PID，等 Caddy 拉起新 worker 并完成 warmup（可通过健康检查端点确认） - 避免在生产环境开
watch: true，它适合开发，不适合灰度或回滚场景
最易被忽略的一点：FrankenPHP 的 worker 进程退出时，不会等待 Symfony 的 kernel.terminate 事件完成 —— 如果你在里面写了异步日志或队列投递，可能丢数据。务必用 pcntl_signal(SIGTERM, ...) 拦截信号，手动触发 cleanup。
