推荐用 symfony new myproject --webapp 创建 symfony 7 项目,自动集成 twig、webpack encore、makerbundle 等全套 web 工具链;需先安装 symfony cli 并验证版本,禁用已弃用的 --full 参数;启动用 symfony server:start,确认欢迎页及 php bin/console about、list、make:controller 均正常。

直接用 symfony new myproject --webapp 创建 Symfony 7 项目,是当前唯一推荐、最省心的方式。它自动拉取完整 Web 工具链,一步到位,不缺 Twig、不缺 Webpack Encore、不缺 MakerBundle,也不用自己配环境变量或 public 目录。
安装并验证 Symfony CLI
没装 CLI 就没法用官方推荐流程——别跳过这步:
- macOS:运行
brew install symfony-cli/tap/symfony-cli - Linux:运行
wget https://get.symfony.com/cli/installer -O - | bash - Windows:去 symfony.com/download 下载图形安装包,双击运行
- 安装完执行
symfony -v,看到版本号(如 v5.17.1)才算成功;若提示 command not found,需手动把~/.symfony/bin(Linux/macOS)或安装目录(Windows)加进系统 PATH
创建项目:只用 --webapp,别碰 --full
--full 参数已在 2025 年底正式弃用,Symfony 7.x 中它要么失败,要么退化为不带模板引擎的精简骨架,导致 $this->render() 报错、“欢迎页打不开”等新手高频问题。
- 正确命令:
symfony new myapp --webapp(项目名不能含空格或中文) - 该命令会自动下载
symfony/website-skeleton,预装 Twig、Webpack Encore、MakerBundle、WebProfilerBundle 和 Flex 自动配置系统 - 完成后你会看到绿色提示 “Project successfully created”,且项目根目录下已有
public/index.php和预设好的.env(APP_ENV=dev、APP_DEBUG=1)
启动服务并确认运行正常
旧式 php bin/console server:run 已弃用,它不支持 HTTPS、无法自动重载环境变量,在 PHP 8.0+ 上还容易端口冲突。
- 进入项目目录:
cd myapp - 启动开发服务器:
symfony server:start(默认监听https://127.0.0.1:8000,首次运行自动生成 TLS 证书) - 浏览器打开链接,看到绿色菊花图标和 “Welcome to Symfony” 即表示成功
- 若页面空白或 500 错误,先检查 PHP 扩展:
php -m | grep -E "pdo|xml|intl|mbstring|curl",缺一不可
快速验证环境是否就绪
光有欢迎页还不够,关键组件是否加载到位,得看控制台输出:
- 运行
php bin/console about,确认三行同时存在:Flex enabled: yes、APP_ENV=dev、APP_DEBUG=1 - 运行
php bin/console list,能看到make:controller、doctrine:*、server:*等上百条命令,说明 Bundle 注册成功 - 试建一个控制器:
php bin/console make:controller TestController,然后访问/test路由,能返回页面即闭环验证完成











