FrankenPHP1.2worker模式代码不更新怎么解决-php教程-PHP中文网

根本原因是php worker常驻内存、复用opcache和框架容器，不自动感知文件变化；必须通过frankenphp stop-workers或启用watch:true触发sigterm使worker优雅退出并由caddy拉起新实例，同时确保路径正确、软链已切、opcache已清。

frankenphp1.2worker模式代码不更新怎么解决

FrankenPHP 1.2 在 worker 模式下代码不更新，根本原因是 PHP worker 进程常驻内存、复用 OPcache 和框架容器，不会自动感知文件变化。改完代码后执行 frankenphp reload 或 caddy reload 完全无效——它们只重载 Caddy 配置，不重启 worker。

要让新代码生效，必须让旧 worker 退出、由 Caddy 拉起新实例，并确保新实例加载的是新路径下的入口文件和缓存。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

✅ 正确触发代码更新的两种方式

启用 watch: true（推荐用于开发环境）
在 frankenphp.yaml 中配置：
```
php_worker: /var/www/current/public/index.php
watch: true
```
- FrankenPHP ≥ 1.2 支持该选项，会监听 .php、.yaml、.env 等变更，自动向当前 worker 发送 SIGTERM
- 注意：不监听 vendor/ 目录；Composer 更新后仍需手动清 OPcache 或重启
手动终止 worker（生产发布标准流程）
运行命令：
```
frankenphp stop-workers
```
- 向所有活跃 worker 发送 SIGTERM，worker 完成当前请求后优雅退出
- Caddy 会立即拉起新 worker（前提是 startup: 1 或未设限）
- 必须在 FrankenPHP 主进程所在宿主机上执行，且 FRANKENPHP_WORKER=1 已设为环境变量

⚠️ 容易失败的隐藏陷阱（务必检查）

入口路径必须是绝对路径
php_worker 指令中不能写 ./public/index.php 或 public/index.php，否则 worker 启动失败，日志仅显示模糊的 "failed to start worker"
✅ 正确写法：/var/www/current/public/index.php
软链接切换后权限与依赖未就绪
执行 ln -sf /var/www/releases/20261015-xx /var/www/current 后，确认：
- public/index.php 可读（ls -l /var/www/current/public/index.php）
- var/cache/ 可写（尤其 Symfony/Laravel 的缓存目录）
- 已运行 composer install --no-dev --optimize-autoloader
- 若使用自定义环境（如 APP_ENV=prod），需在 Caddyfile 中显式传入：
```
php_worker /var/www/current/public/index.php {
    env APP_ENV=prod
}
```
OPcache 未清理导致旧字节码仍在运行
即使 worker 重启，若 OPcache 缓存了旧文件哈希，仍可能加载错误逻辑
✅ 解决方法（任选其一）：
- 调用 opcache_reset()（需 PHP CLI 或 Web 端可访问）
- 使用 frankenphp opcache-reset（若二进制支持）
- 启动时加参数强制刷新：--php-flags "-d opcache.validate_timestamps=1"

? 不起作用的操作（别再试）

caddy reload 或 frankenphp reload → 只重载路由/TLS/静态路径，不碰 worker
直接覆盖代码或切软链后等待 → worker 复用旧 OPcache，大概率报 Class not found 或 Cannot declare class
kill -9 $PID → 强杀无优雅退出，Caddy 可能无法及时拉起新实例，造成短暂不可用
修改 .env 或 config/*.yaml 后不重建缓存 → Symfony/Laravel 读的是编译后的 var/cache/prod/，不是原始配置文件

? 发布时的标准三步顺序（缺一不可）

部署新代码到独立 release 目录，并完成 composer install 和权限设置

切换软链 + 清缓存：

ln -sf /var/www/releases/20261015-xxxx /var/www/current
php artisan config:clear && php artisan cache:clear  # Laravel
# 或
php bin/console cache:clear --env=prod               # Symfony
opcache_reset()