FrankenPHP 1.2 升级未改变 worker 模式架构，但强化了运行时状态管理、PHP 8.3 兼容性、Caddy 集成及日志调试能力，使常驻行为更透明可控。
FrankenPHP 1.1 升级到 1.2 后，worker 模式本身没有发生架构级变更，核心机制（单进程常驻、复用类加载/OPcache/配置解析、通过 frankenphp_handle_request() 调度请求）保持一致。但 1.2 版本在稳定性、兼容性和开发体验上做了若干关键改进，直接影响 worker 模式的实际使用效果。
更严格的运行时状态管理要求
1.2 强化了对“伪常驻”特性的文档提示与行为约束：
- 显式要求开发者在每次请求处理前主动清理易污染的全局状态，例如
$_SERVER、$_ENV、静态属性、PDO 实例等； - 新增
frankenphp_clear_globals()工具函数（推荐在worker.php入口的请求循环中调用），替代手动unset或重置； - 对未重置的
chdir()导致的路径污染问题，日志中会输出更明确的 warning 提示（如CWD changed in previous request, require() may fail）。
PHP 运行时兼容性增强
- 完整支持 PHP 8.3 的新特性（如
#[\Override]、只读类默认行为），且 worker 模式下opcache.preload加载更稳定，避免 1.1 中偶发的预加载类未生效问题； - 修复了
pcntl_*函数在 worker 循环中多次调用导致的信号处理异常（如SIGUSR2触发重启后子进程残留）； -
FRANKENPHP_WORKERS环境变量现在可动态生效（配合--workers=N启动参数），不再强制依赖编译时设定。
Caddy 集成层优化影响 worker 行为
- HTTP/3 支持更健壮，worker 进程能正确处理 QUIC 连接复用带来的长连接请求批次；
- 自动 HTTPS 证书续期过程不再触发 worker 进程意外 reload（1.1 中曾因 Caddy 内部 reload 导致 worker 重启丢失连接池）；
- 反向代理场景下，
php_server指令与worker模式共存时，路径匹配逻辑更清晰，避免误将静态资源路由进 PHP worker。
日志与调试能力提升
- 所有 worker 相关错误（包括
require失败、连接超时、协程调度异常）统一归入 Caddy 的 structured JSON 日志，字段增加"worker_id"和"request_id"，便于追踪跨请求状态； - 新增
--debug-worker启动标志，启用后会在每次frankenphp_handle_request()调用前后打印内存使用快照和已加载类数量，方便定位泄漏点。
本质上，1.2 不是给 worker 模式加新功能，而是让它的“常驻但不自动清理”这一本质更透明、更可控、更少意外。升级后无需改业务逻辑，但建议同步更新 worker.php 入口脚本，加入标准清理流程和日志上下文。
