推荐使用 symfony cli 工具创建 symfony 7.4.21 基础项目,命令为 symfony new my_project --version=7.4.21 --webapp,自动完成版本对齐、扩展检查、web 服务器配置与环境初始化,启动后访问 https://127.0.0.1:8000 即可见欢迎页。

使用 Symfony 7.4.21 创建基础 App 项目,推荐通过官方推荐的 symfony CLI 工具(而非 Composer 直接安装),它会自动处理版本对齐、Web 服务器配置和环境初始化,避免手动踩坑。
确认系统前提条件
Symfony 7.4 要求 PHP ≥ 8.1(建议 8.2+),并启用 curl、json、mbstring、xml、ctype、iconv 等扩展。可通过以下命令快速验证:
-
php -v—— 确保输出为PHP 8.1.x或更高 -
php -m | grep -E 'curl|json|mbstring|xml|ctype|iconv'—— 检查必需扩展是否已加载 -
curl -sS https://get.symfony.com/cli/installer | bash安装最新版 Symfony CLI(Linux/macOS);Windows 用户请下载 官方 .exe 安装包
创建项目并指定 Symfony 7.4.21 版本
Symfony CLI 支持精确指定稳定小版本。运行以下命令即可生成干净、可立即运行的基础 App:
symfony new my_project --version=7.4.21 --webapp-
--webapp参数会预装 Twig、Doctrine、MakerBundle、WebProfilerBundle 等常用组件,适合传统全栈开发 - 不加该参数则生成最小化 skeleton(仅核心组件),适合 API 或微服务场景
- 项目创建后自动执行
composer install和npm install(如含 assets)
启动本地开发服务器
进入项目目录后,直接用 Symfony CLI 启动内置 Web 服务器(基于 PHP 的 router.php,无需 Apache/Nginx):
cd my_project-
symfony server:start—— 默认监听https://127.0.0.1:8000(支持 HTTPS 自签名证书) - 首次运行会提示你允许本地证书,按提示操作即可;也可加
--no-tls强制 HTTP 模式:symfony server:start --no-tls - 终端将显示实时请求日志,Ctrl+C 停止服务
验证安装与快速入门
服务启动后,浏览器访问 https://127.0.0.1:8000 应看到 Symfony 默认欢迎页,并显示当前版本号(7.4.21)。接下来可:
- 查看环境配置:
php bin/console about输出 PHP/Symfony/环境信息 - 生成控制器:
php bin/console make:controller HomepageController(需已安装 MakerBundle) - 查看路由列表:
php bin/console debug:router - 开启开发模式调试工具栏:确保
.env中APP_ENV=dev且未设APP_DEBUG=0











