FrankenPHP热更新需满足：版本≥1.2、项目根目录下frankenphp.yaml含watch: true、FRANKENPHP_WORKER=1环境变量生效、当前用户对项目有读执行权限；修改后自动重启worker并生效。
FrankenPHP 安装后要实现代码修改自动生效，关键不是“安装完就开热更新”，而是正确启用 watch: true 并满足其运行前提。它不依赖系统 inotify 或外部脚本，是 FrankenPHP 自带的、专为开发设计的监听机制。
确认 FrankenPHP 版本支持
热更新监听功能仅在 FrankenPHP ≥ 1.2 中可用。运行以下命令验证：
-
frankenphp version—— 查看主版本号 -
frankenphp run—— 启动时第一行日志会显示实际加载的 PHP 版本及构建时间，也佐证是否为新版
配置 frankenphp.yaml 启用 watch
该文件必须位于项目根目录（即 frankenphp.yaml 所在路径就是监听起点），内容需包含：
-
watch: true—— 必须显式开启，缺省为false -
FRANKENPHP_WORKER=1需作为环境变量生效（推荐写入.env或启动命令中） - 可选加
ignore: [".*"]过滤编辑器临时文件，避免误触发
注意：路径必须正确。若把 frankenphp.yaml 放在 /etc/frankenphp/ 而项目在 /var/www/app，监听完全不会启动。
立即学习“PHP免费学习笔记（深入）”；
确保运行权限与文件范围匹配
FrankenPHP 以当前用户身份运行（如 www-data），该用户必须对项目根目录有 读 + 执行 权限，否则 fsnotify 初始化失败，日志仅显示 failed to start watcher。
- 默认监听
.php、.yaml、.yml、.env、.ini文件 -
不监听
vendor/目录 —— Composer 更新后需手动opcache_reset()或重启进程 - 修改
public/index.php或config/services.yaml会触发，改src/Controller/HomeController.php同样有效
验证监听是否生效
启动服务后做一次小修改（如在控制器里加个 die('test');），保存文件：
- 终端应立即输出类似
Watcher detected change in config/services.yaml, sending SIGTERM to worker - 旧 worker 完成当前请求后退出，Caddy 自动拉起新实例
- 刷新页面，新逻辑应立刻生效；检查
opcache_get_status()['scripts']可确认路径已更新
如果没反应，优先检查 frankenphp.yaml 位置、权限、FRANKENPHP_WORKER 环境变量是否就位。
