FrankenPHP是将Caddy与PHP运行时深度集成的单体应用服务器,替代整条Nginx+PHP-FPM链路,实现HTTP/3、自动TLS、常驻内存worker模式等一体化能力。

FrankenPHP 不是 PHP-FPM 的平替,也不是另一个 Swoole 替代品;它是把 Caddy 和 PHP 运行时焊死在一个进程里的单体应用服务器——部署时你只启动一个二进制,它就同时干了 Nginx、PHP-FPM、TLS 终止、HTTP/3 协议栈、甚至 Mercure 推送的事。
FrankenPHP 要替代的不是 PHP-FPM,而是整条链路
传统 Nginx + PHP-FPM 架构里,每个请求要跨至少两个进程:Nginx 解析路由、转发 fastcgi 请求,PHP-FPM 拉起 worker、加载框架、执行脚本、销毁上下文。这中间有 socket 通信开销、重复 bootstrap(比如 Laravel 每次初始化容器要 20–50ms)、配置分散(nginx.conf、www.conf、php.ini 各管一摊)。
FrankenPHP 把这些全收进一个 Go 进程:HTTP 请求进来,Caddy 模块直接交给嵌入的 PHP 运行时,无需进程间跳转;静态文件由 Caddy 原生服务,PHP 脚本走内存内调用,连 Unix socket 都省了。
- 不兼容的不是语法,而是运维习惯:你不再需要
systemctl restart php-fpm,只需重启frankenphp进程 - 它默认启用 OPcache 且预加载更激进,
opcache.preload在 worker 模式下效果翻倍 - HTTP/3 和自动 TLS(通过 Caddy 的
https://自动证书)开箱即用,不用额外配 acme.sh 或 certbot
classic 模式 vs worker 模式:别直接上 worker
classic 模式行为接近 PHP-FPM:每次请求启动新 PHP 生命周期,适合调试、小流量站、或尚未适配常驻模型的旧项目(比如某些依赖 register_shutdown_function 清理资源的代码)。
worker 模式才是 FrankenPHP 的核心价值:PHP 进程常驻,框架初始化只做一次,后续请求复用已加载的类、容器、数据库连接池。但这也带来几个硬约束:
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
- 全局变量和静态属性不会自动重置,
$_SESSION、static::$cache会跨请求残留,必须显式清理或改用 request-scoped service - 不能依赖
__destruct()或 shutdown function 做关键释放(因为进程不退出),要用frankenphp\on_request_end()注册回调 - 数据库连接需配置
persistent: true并手动处理断连重试,否则长连接超时后会卡死
它真能跑 Laravel/Symfony/ThinkPHP 吗?能,但得改两处
绝大多数现代框架开箱兼容,但有两个高频踩坑点:
-
public/index.php里不能直接 exit,要改成return $response->send();(否则 worker 模式下进程卡住不返回) - 日志路径不能写死相对路径,比如
__DIR__.'/../storage/logs',因为 worker 进程工作目录可能不是 webroot;应改用getcwd()或环境变量FRANKENPHP_APP_ROOT - 如果你用了
pcntl_fork()或proc_open(),在 worker 模式下会出问题——Go 主进程不支持 fork,这类调用会静默失败
什么时候不该用 FrankenPHP?
它不是万能胶。以下场景建议继续用 Nginx + PHP-FPM:
- 需要和其它语言服务(如 Python FastAPI、Node.js)共用同一个反向代理层,且已有成熟 Nginx 流量调度策略
- PHP 应用必须运行在非 Linux 系统(Windows/macOS 上 FrankenPHP 仅支持开发模式,无生产级 HTTP/3 或 worker 支持)
- 团队完全没接触过 Go 生态,又极度依赖
gdb调试 PHP 内核级问题——FrankenPHP 的堆栈混合了 Go 和 Zend,core dump 分析门槛陡增
真正关键的取舍点不在性能数字,而在于你愿不愿意把“Web 服务器 + PHP 运行时 + TLS 管理”这三件事的控制权,从多个配置文件和进程,收束到一个二进制和一份 Caddyfile 里。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










