Symfony 7.0 创建项目应使用 symfony new myapp --webapp 命令,预装 Twig、Webpack Encore 等 Web 工具链;运行 symfony server:start 并访问 https://127.0.0.1:8000 验证欢迎页即成功。

直接用 symfony new 命令就能快速生成一个开箱即用的 Symfony 项目,不用碰 composer.json、不手动配环境、不查包名——前提是已装好 Symfony CLI。
确保 Symfony CLI 已安装
没装的话,先装工具:
- macOS:运行
brew install symfony-cli/tap/symfony-cli - Linux:运行
wget https://get.symfony.com/cli/installer -O - | bash - Windows:下载并运行官方安装程序(如 Symfony CLI 5.17.1)
装完执行 symfony -v,看到版本号(比如 v5.12.0)就说明准备好了。如果提示 command not found,请重启终端,或把 ~/.symfony/bin 加进 PATH。
一条命令生成带 Web 能力的项目
运行:
symfony new myproject --webapp其中 myproject 是你要创建的目录名,不能含空格或中文。这条命令会自动拉取 symfony/website-skeleton,预装 Doctrine、Twig、MakerBundle、WebProfiler 和 Flex,并生成完整的 public/index.php 和开发环境配置。
注意:不加 --webapp 就只是轻量骨架(symfony/skeleton),连 public 目录都没有,访问直接 404。
启动服务并验证
进项目目录:cd myproject
启动内置服务器:symfony server:start
它会自动启用 HTTPS、生成本地证书、打开浏览器访问 https://127.0.0.1:8000。首次运行可能弹窗提示信任证书,点允许即可。
验证是否跑通,运行:php bin/console about,重点看三行:
Flex enabled: yesAPP_ENV=devAPP_DEBUG=1
缺任何一个,后续做控制器、模板或命令都可能失败。
常见卡点与应对
如果 symfony new 卡在 “Installing dependencies”,大概率是网络慢,可临时切 Composer 镜像:composer config -g repo.packagist composer https://packagist.phpcomposer.com
如果 php bin/console 报错 “Could not open input file”,检查是否在项目根目录,或 Linux/macOS 下执行:chmod +x bin/console
Windows 用户若提示 “The system cannot find the path specified”,建议改用 Git Bash 或 CMD 运行,避开 PowerShell 执行策略限制。


















