直接上手 Symfony 应先用最小闭环跑通可访问页面:装好 PHP(8.0+)、Composer、Symfony CLI,运行 composer create-project symfony/website-skeleton myapp,启动 symfony server:start,访问 https://localhost:8000 成功显示欢迎页;再执行 php bin/console make:controller HomeController,修改控制器和 templates/home/index.html.twig,刷新 /home 显示动态内容;调试时善用页面右下角紫色调试栏和 /_profiler 查看请求详情。

直接上手 Symfony,关键不是先啃完所有文档,而是用最小闭环跑通一个可访问的页面。它不依赖复杂配置,但对环境和目录逻辑有明确要求。
装好三样基础工具
缺一不可:PHP(8.0+)、Composer、Symfony CLI。别跳过 CLI —— 它比纯 Composer 创建项目更快、自带开发服务器和命令补全。验证是否装好,终端运行 php -v、composer -V、symfony -V,三者都应正常输出版本号。
用 website-skeleton 创建第一个项目
新手别从 skeleton 开始,它太精简,缺模板引擎和 Web 工具,容易卡在“页面出不来”。推荐一步到位:
- 运行 composer create-project symfony/website-skeleton myapp
- 进入目录:cd myapp
- 启动服务:symfony server:start
- 浏览器打开 https://localhost:8000,看到 Symfony 的欢迎页才算成功
改出你的第一行动态内容
欢迎页只是静态 HTML。要真正理解流程,马上动手改控制器和模板:
- 运行 php bin/console make:controller HomeController
- 编辑 src/Controller/HomeController.php,在 index() 方法里加一句 return $this->render('home/index.html.twig', ['name' => '张三']);
- 在 templates/home/index.html.twig 中写 <h1>你好,{{ name }}!</h1>
- 刷新 /home 路径,看到带名字的标题,MVC 就活了
学会查错和看调试栏
Symfony 把调试集成进页面底部——只要没关掉 debug 模式(默认开启),页面右下角就有紫色小条。点开就能看路由匹配结果、数据库查询、Twig 变量值、异常堆栈。遇到白屏或 500 错误,先点它;报错信息里常带文件名和行号,比日志更直给。想看完整请求生命周期,访问 https://localhost:8000/_profiler。


















