直接上手 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 Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

• 运行 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 中写：

  你好，{{ name }}！

• 访问 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')]