直接上手 symfony 8.0 的关键是5分钟内跑通欢迎页：装好 php 8.0+、composer 2.5+ 和 symfony cli 5.5+，运行 symfony new myapp --full，cd myapp 后 symfony server:start，访问 https://www.php.cn/link/261f67921edd024375a9a83e9ddf6a47 即可；再用 make:controller 创建 homecontroller，修改 index() 返回渲染模板，访问 /home 显示“你好，李四！”即验证 mvc 流通；调试时善用 web debug toolbar 和 _profiler。
直接上手 Symfony 8.0，关键不是先读完文档，而是用最小闭环跑通一个能访问的页面。它对环境有明确要求，但配置本身不复杂——装好三样基础工具、创建项目、启动服务、看到欢迎页，整个过程5分钟内可完成。
装好必需的本地开发工具
缺一不可，且版本需匹配：
-
PHP 8.0+：Symfony 8.0 要求最低 PHP 8.0。运行
php -v确认输出版本号 ≥ 8.0；若未安装，macOS 推荐brew install php，Ubuntu/Debian 用sudo apt install php8.0-cli php8.0-xml php8.0-mbstring php8.0-intl php8.0-curl -
Composer 2.5+：用于依赖管理。运行
composer -V检查，如未安装，执行官方一键脚本：curl -sS https://getcomposer.org/installer | php，再移至/usr/local/bin/composer -
Symfony CLI 5.5+：比纯 Composer 更高效，自带开发服务器、命令补全和调试支持。Linux/macOS 运行：
curl -sS https://get.symfony.com/cli/installer | bash，并确保$HOME/.symfony/bin在 PATH 中；验证用symfony -V
创建并启动第一个 Symfony 8.0 项目
别选 skeleton——它太精简，缺模板引擎和 Web 工具，新手容易卡在“页面出不来”。推荐一步到位：
- 运行
symfony new myapp --full（--full会安装完整版，含 Twig、WebProfiler、Doctrine 等常用组件） - 进入项目：
cd myapp - 启动开发服务器：
symfony server:start - 浏览器打开 https://www.php.cn/link/261f67921edd024375a9a83e9ddf6a47，看到 Symfony 8 的欢迎页即成功
写出第一行动态内容（验证 MVC 流程）
欢迎页是静态的。要真正理解请求如何从路由→控制器→模板流转，立即动手改写：
- 生成控制器：
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> - 访问 https://www.php.cn/link/261f67921edd024375a9a83e9ddf6a47/home，看到带名字的标题，说明控制器、路由、模板全部打通
调试与排错：善用内置工具
Symfony 8.0 默认开启 debug 模式，调试信息就藏在你眼前：
- 页面右下角紫色小条（Web Debug Toolbar）点开即可查看：当前路由匹配结果、Twig 变量值、数据库查询（如有）、异常堆栈 —— 白屏或 500 错误时，先看它
- 想看完整请求生命周期？访问 https://www.php.cn/link/261f67921edd024375a9a83e9ddf6a47/_profiler，所有细节一目了然
- 常见问题快速定位：
-
Connection refused / No such file or directory → 检查
.env中DATABASE_URL是否用了127.0.0.1（别用localhost） -
Class not found / Undefined function → 缺 PHP 扩展，运行
php -m | grep -E 'intl|mbstring|xml'确认已启用 -
404 on /home → 控制器没加
@Route注解，检查make:controller是否自动生成了路由，或手动添加#[Route('/home', name: 'home')]
-
Connection refused / No such file or directory → 检查
