FrankenPHP可让Symfony项目免Nginx+PHP-FPM三层配置、容器常驻内存、自动证书续期、HTTP/3开箱即用、静态资源零配置直出、开发生产配置一致,并打包为单二进制文件交付。

用FrankenPHP跑Symfony项目,能直接绕过Nginx+PHP-FPM的三层配置、避免每次请求重复加载容器、省掉Let’s Encrypt证书手动续期流程、HTTP/3开箱即用、还能把整个应用打包成单二进制文件交付——这些不是未来设想,是今天就能在生产环境跑通的事实。
免配Nginx,Caddy内置路由全接管
删掉你项目根目录下所有nginx.conf、sites-available配置和systemd服务单元文件。FrankenPHP自带Caddy,只需一个Caddyfile就定义全部行为。
在项目根目录创建Caddyfile,内容如下:
https://myapp.local {
php_backend
encode zstd gzip
file_server
}
执行frankenphp php-server --caddyfile Caddyfile,服务立即启动。Caddy自动监听443端口、检测域名、向Let’s Encrypt申请并续期证书——【必须绑定真实域名,不能用localhost或127.0.0.1】。
这一步不依赖任何外部Web服务器,也不需要修改Symfony的public/index.php入口逻辑。
Worker模式让容器常驻内存
Symfony每次HTTP请求都要重建Kernel、重注册Bundle、重新解析config/*.yaml,这个过程在FPM里无法复用。FrankenPHP的worker模式彻底解决这个问题。
方法一:启用内置worker(推荐)
在Caddyfile中把php_backend改为php_backend worker,重启服务即可生效。
方法二:手动启动worker进程
运行frankenphp worker --env=prod --document-root=public/,它会预加载config/bootstrap.php和src/Kernel.php,后续所有请求共享同一个已初始化的容器实例。
注意:启用worker后,var/cache/prod目录必须可写,否则缓存无法热更新。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
静态资源零配置直出
传统部署中,Nginx负责托管public/build/下的CSS/JS,PHP-FPM只处理.php后缀。FrankenPHP把这事合并了。
只要确保public/是文档根目录,Caddy的file_server指令就会自动识别.css、.js、.woff2等扩展名,直接返回文件,不经过PHP解析器。
这步不需要额外配置MIME类型或添加location块——Caddy内置了完整的现代Web资源映射表。
开发与生产配置完全一致
第一步:在.env中设置APP_ENV=prod和APP_DEBUG=0;
第二步:清空var/cache;
第三步:运行frankenphp php-server --caddyfile Caddyfile。
以上三步在本地Mac、测试服务器、生产云主机上完全相同。没有php-fpm.conf的pm.max_children参数要调,没有nginx.conf的fastcgi_buffers要试错,也没有/etc/systemd/system/php-fpm.service要重载。
整个生命周期由单个FrankenPHP进程管理,日志统一输出到stdout,可直接被Docker或systemd捕获。
打包成单二进制交付
第一步:安装frankenphp-packager工具:go install github.com/dunglas/frankenphp/cmd/frankenphp-packager@latest;
第二步:进入项目根目录,执行frankenphp-packager --env=prod --document-root=public/ --output=myapp;
第三步:生成的myapp文件就是完整可执行程序,拷贝到任意Linux服务器(glibc ≥ 2.28)即可运行:./myapp --caddyfile Caddyfile。
这个二进制包含:Caddy服务器、PHP解释器、OPcache预热后的字节码、你的全部PHP源码和assets。无需目标机器安装PHP、无需Composer、无需扩展.so文件。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










