最标准方式是用Composer创建:composer create-project symfony/symfony:5.4.54 my_project,要求PHP≥7.2.5及phar、openssl等扩展启用,安装后运行php bin/console about验证版本为v5.4.54。

直接用 Composer 安装 Symfony 5.4.54 是当前最标准、最可控的方式。Symfony Installer 已于 2022 年弃用,官方全面转向 Composer 驱动的项目创建流程。5.4.54 是 Symfony 5.4 系列的一个具体补丁版本(属于长期支持 LTS 版本),它要求 PHP ≥ 7.2.5,且需确保 phar、openssl、json、mbstring、xml、ctype、tokenizer 等扩展已启用。
确认环境并安装 Composer
先检查 PHP 版本和关键扩展:
- 运行
php -v,确认输出为 7.2.5 或更高版本(如 7.4.x、8.0.x) - 运行
php -m | grep -E "phar|openssl|mbstring"(Linux/macOS)或查看phpinfo()页面,确保无缺失 - 若未安装 Composer,推荐使用官方安装脚本:
curl -sS https://getcomposer.org/installer | php
然后移至全局路径:sudo mv composer.phar /usr/local/bin/composer(Linux/macOS)
创建指定版本的 Symfony 5.4.54 项目
不依赖全局 installer,而是用 Composer 的 create-project 命令精准拉取目标版本:
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
- 执行命令:
composer create-project symfony/symfony:5.4.54 my_project - 该命令会从 Packagist 下载 symfony/symfony 包的 5.4.54 版本(即完整框架发行版),自动安装依赖、生成
vendor/和autoload.php - 注意:不要用
symfony/website-skeleton,它默认指向最新稳定版(可能是 6.x),无法锁定 5.4.54
验证安装并启动开发服务器
进入项目后快速验证是否就绪:
- 运行
cd my_project && php bin/console about,查看输出中 Symfony version 是否为v5.4.54 - 检查核心组件版本:
composer show symfony/framework-bundle应返回v5.4.54 - 启动内置服务器:
php bin/console server:run(Symfony 5.4 仍保留该命令)或更推荐:symfony server:start(需额外安装 Symfony CLI,但非必需) - 浏览器访问
http://127.0.0.1:8000,应看到 Symfony 默认欢迎页
后续基础配置建议
刚搭建完,建议立即做三件事以保障开发稳定性:
-
设置时区与错误报告:在
.env中确认APP_ENV=dev和APP_DEBUG=1;在config/packages/framework.yaml中设置default_timezone: 'Asia/Shanghai' -
启用 Validator 组件(表单验证必需):
composer require validator -
初始化数据库配置:编辑
.env中的DATABASE_URL,例如mysql://root:password@127.0.0.1:3306/mydb,再运行php bin/console doctrine:database:create

















