必须首行日志为“starting frankenphp server”且无frankenphp-worker进程，才能确认真在经典模式：检查ps输出、终端首行日志，并清除frankenphp_worker=1和caddyfile中php { worker }配置。
确认当前是否真在经典模式下运行
别跳步。很多团队一上来就改 worker.php，结果发现压根没进经典模式——比如 Caddyfile 里还留着 php { worker }，或环境变量 FRANKENPHP_WORKER=1 没清干净。启动时第一行日志必须是 Starting FrankenPHP Server（不含 Worker 字样），否则所有后续改造都建立在错误前提上。
检查方法：
– 运行 ps aux | grep frankenphp，确认没有 frankenphp-worker 或 frankenphp-worker.php 进程
– 查看终端启动输出首行
– 执行 frankenphp php-cli -m | grep opcache，确认 opcache 已启用（Worker 模式强依赖它）
用 Octane 替换入口、不碰原有逻辑
FrankenPHP 的 Worker 模式在 Laravel 场景下，官方路径是走 laravel/octane，不是手写 worker.php。你不需要重写 public/index.php，也不需要手动调 frankenphp_handle_request()——Octane 已封装好生命周期控制。
实操步骤：
– 运行 composer require laravel/octane
– 执行 php artisan octane:install --server=frankenphp（注意参数必须显式指定）
– 它会生成 config/octane.php 并修改 server 键为 'frankenphp'（别拼错，比如多空格或大小写）
– 启动前确保 FRANKENPHP_WORKER=1 已设，且 Caddyfile 中有 php { worker } 块
关键点：Octane 生成的 vendor/bin/frankenphp-worker.php 是真实入口，它已处理了初始化、请求循环、GC 回收和连接复位。你原来的 public/index.php 只会被它按需加载一次，不再直面请求。
排查无状态泄漏的三个高频位置
Worker 模式下最常出问题的不是框架本身，而是你代码里“以为只跑一次”的副作用。FrankenPHP 不会帮你清掉静态变量、全局数组或未关闭的资源句柄。
重点检查：
– 服务提供者中的单例绑定：比如 $this->app->singleton('cache.driver', function () { return new RedisCache(); }); —— 如果这个 RedisCache 实例持有连接，且没实现自动重连或超时断开，第二次请求可能复用失效连接
– 中间件里的静态缓存：像 static $user = null; + if (!$user) { $user = User::find(1); }，会导致后续请求拿到上一个用户的实例
– 手动打开的文件或 socket：比如在 boot() 里 fopen('/tmp/log.txt', 'a')，没 fclose()，文件指针会一直占用，多次请求后 fd 耗尽
验证方式：在本地启一个 Worker 进程，发两个不同用户 ID 的请求，然后 dd($request->user()) 看是否被污染；或用 lsof -p $(pgrep frankenphp) 查看打开的文件描述符是否持续增长。
数据库连接和 OPcache 必须显式配置
默认配置在 Worker 下大概率出错。PDO 持久连接（PDO::ATTR_PERSISTENT）不能开，OPcache 的 opcache.validate_timestamps 必须关——这两项不调，轻则响应变慢，重则返回上一个请求的数据。
调整项：
– 数据库配置中明确设置 'options' => [PDO::ATTR_PERSISTENT => false]（Laravel 在 config/database.php 的 mysql.options 下加）
– php.ini 或 FrankenPHP 启动参数中加入 opcache.validate_timestamps=0 和 opcache.max_accelerated_files=20000（默认值太小，类多时会频繁踢出缓存）
– 如果用 Redis 作缓存/队列，确保连接使用 connect() 而非 pconnect()，并确认 redis.timeout 设得合理（建议 ≤5）
容易忽略的一点：Laravel 的 APP_KEY 和 APP_ENV 必须通过环境变量注入，不能靠 Dotenv 在 worker 启动后读取——因为 Dotenv 只执行一次，后续请求无法刷新。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
