FrankenPHP+ Symfony开发环境配置教程【新手必看】

风枫君_4596

风枫君_4596

2026-10-04

945人浏览

原创

FrankenPHP可一键启动支持HTTPS、HTTP/2的Symfony开发环境,内置Caddy免配Web服务器,仅需安装二进制、创建Caddyfile并执行frankenphp run即可。

frankenphp+ symfony开发环境配置教程【新手必看】 - php中文网

要在本地快速启动一个支持现代HTTP特性的Symfony开发环境,必须绕过传统PHP-FPM+Apache/Nginx组合的繁琐配置,直接用FrankenPHP接管HTTP服务与PHP执行——它内置Caddy,开箱即用HTTPS、HTTP/2、Early Hints,且无需额外配置Web服务器或修改hosts。

确认系统基础条件

FrankenPHP要求Linux/macOS或Windows WSL2,不支持原生Windows CMD/PowerShell直跑;确保已安装curl和unzip命令,否则后续自动安装脚本会中断。

运行which curl unzip,若任一命令报“command not found”,请先安装:macOS用brew install curl unzip,Ubuntu/Debian用sudo apt install curl unzip。

【必须关闭已占用80/443端口的进程】,比如Docker Desktop、MAMP、XAMPP或另一个FrankenPHP实例,否则frankenphp run会立即退出并报错“address already in use”。

安装FrankenPHP二进制

推荐使用官方自动安装脚本,适配所有主流平台:

方法一:一键安装(macOS/Linux)
执行curl -L https://frankenphp.dev/install.sh | sh → 等待下载解压完成 → 脚本自动将frankenphp二进制移至/usr/local/bin/ → 运行frankenphp --version验证输出类似FrankenPHP v1.2.0 (Caddy v2.8.4)。

方法二:手动安装(Windows WSL2或需自定义路径)
访问https://github.com/dunglas/frankenphp/releases → 找到最新frankenphp_*.tar.gz文件 → 下载后解压 → 运行chmod +x frankenphp → sudo mv frankenphp /usr/local/bin/。

注意:不要用npm install -g frankenphp或pip install frankenphp——它根本不存在,那些是伪造包。

创建Symfony项目并适配FrankenPHP

第一步:用symfony new创建带完整Web栈的项目
执行symfony new myapp --webapp → 确保看到Flex: enabled和assets installed提示 → 进入cd myapp。

Build MCP servers and clients for PHP applications with the official PHP SDK
Build MCP servers and clients for PHP applications with the official PHP SDK

使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

下载

第二步:禁用Symfony内置PHP服务器冲突
删除symfony server:start可能残留的.symfony/目录,执行rm -rf .symfony → 否则FrankenPHP启动时会因端口竞争失败。

第三步:准备public目录结构
Symfony 7默认生成public/,但FrankenPHP要求入口为public/index.php且静态资源可直接访问。确认ls public/index.php存在,若无则运行composer require symfony/web-server-bundle --dev再执行php bin/console assets:install补全。

第四步:添加FrankenPHP专属配置文件
在项目根目录新建Caddyfile,内容仅一行:localhost { php_backend } → 这告诉Caddy把所有请求交给PHP处理,无需写路由重写规则。

启动并验证开发服务

进入项目根目录,执行frankenphp run → 终端输出INFO server running on https://localhost及http://localhost两个地址 → 不要关掉这个终端。

打开浏览器访问http://localhost → 看到Symfony欢迎页即成功;若显示404,检查是否误将Caddyfile放在public/内而非项目根目录。

访问https://localhost时浏览器会警告证书无效,点击“继续前往”即可——FrankenPHP自动生成的本地证书无需手动导入。

执行php bin/console debug:router → 输出至少包含_wdt、_profiler、_error三条路由 → 证明Symfony内核已由FrankenPHP完整加载。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

13164

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7541

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2275

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4768

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5474

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

4311

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

6257

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4922

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12602

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习