symfony new myapp --webapp是2026年官方唯一推荐的初始化命令,直接生成含twig、doctrine、makerbundle、webprofiler和flex的开箱即用web应用,不加--webapp则退化为无public目录的最小骨架,访问即404。

用 Symfony CLI 一键初始化新项目,核心就一条命令:
symfony new myapp --webapp
这个命令不是“简化版”,而是当前(2026年)官方唯一推荐的起手方式,直接生成开箱即用的 Web 应用,不用配路由、不用装 Twig、不用手动建 public 目录。
为什么必须加 --webapp?
不加会退化成最小骨架(symfony/skeleton),它连 public/ 目录都没有,浏览器访问直接 404。加上后自动拉取 symfony/website-skeleton,预装:
- Twig 模板引擎(
templates/目录就绪) - Doctrine ORM(数据库基础已就位)
- MakerBundle(支持
make:controller等命令) - WebProfilerBundle(开发时能看到调试工具栏)
- Flex 自动配置系统(依赖注册、配置文件生成全自动化)
执行前确认三件事
避免卡在第一步:
-
PHP 版本 ≥ 8.0(运行
php -v确认) -
已安装 Symfony CLI(运行
symfony -v,看到 v5.x 或 v6.x 即可) -
项目名不含空格、中文或特殊符号(比如
my-blog可以,我的项目或my app会失败)
创建后立刻验证是否成功
进目录,跑三行命令:
-
php bin/console about→ 看到 Flex enabled: yes、APP_ENV=dev、APP_DEBUG=1 -
php bin/console list→ 命令列表里有make:controller、doctrine:database:create等 -
symfony server:start→ 浏览器打开 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913,显示绿色菊花和 “Welcome to Symfony”
不复杂但容易忽略。











