Symfony 7.2 框架快速入门与核心组件解析【新手必看】-php教程-PHP中文网

symfony 7.2 默认启用严格模式、强制类型提示并禁用动态服务注册，要求代码严格遵循容器契约：src/类需显式配置自动加载，控制器须注册为服务且继承abstractcontroller，request等对象必须通过类型提示注入，注解路由需启用扫描，dump()仅在dev环境生效。

symfony 7.2 框架快速入门与核心组件解析【新手必看】

Symfony 7.2 不是“装完就能跑”的玩具框架，它默认启用严格模式、强制类型提示、禁用运行时动态服务注册——这意味着你照着旧教程写 new Controller() 或手动 get('service_name') 会直接报错。必须按容器契约来组织代码，否则连 php bin/console 都执行失败。

symfony new --full 创建项目后，为什么 bin/console 报 ClassNotFound？

这是 Symfony 7.2 最常见的起步卡点：默认不再自动加载 src/ 下所有类，也不再扫描 Controller 目录。错误常表现为 Class "App\Controller\DefaultController" not found，哪怕文件明明存在。

检查 config/services.yaml 是否保留了这段关键配置（7.2 默认已删）：

App\:
    resource: '../src/'
    exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'

确保 src/ 下的类命名空间是 App\，且文件名与类名严格一致（如 ExampleController.php → class ExampleController）
如果用了 PHP 8.2+，注意 #[Route] 注解需在控制器方法上，且该类必须继承 AbstractController 或实现 ControllerInterface

HttpFoundation 的 Request 对象不能直接 new，该怎么取参数？

7.2 中 Request 是容器管理的服务，不是工具类。试图 new Request() 或调用静态 createFromGlobals() 会绕过 Symfony 的请求生命周期，导致 session、csrf、locale 等全部失效。

Symfony Linux版

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

下载

在控制器方法中直接声明类型提示：public function index(Request $request): Response，容器自动注入当前请求实例
获取查询参数：$request->query->get('page', 1)（不建议用 $_GET）
获取请求体 JSON：$request->toArray()（前提是 Content-Type: application/json）
上传文件必须用 $request->files->get('avatar')，而非 $_FILES —— 后者不会触发 Symfony 的文件验证和临时路径管理

Routing 注解失效或 404，检查这三处硬性约束

Symfony 7.2 路由系统默认关闭注解扫描，且要求控制器类必须被容器识别为服务。常见现象是访问 /hello/world 返回 404，但 php bin/console debug:router 却看不到该路由。

确认 config/routes.yaml 包含注解路由配置：

controllers:
    resource: ../../src/Controller/
    type: annotation

控制器类必须有服务定义：要么靠 services.yaml 的自动注册（见上文 App\: 段），要么显式声明：
```
App\Controller\ExampleController:
    tags: ['controller.service_arguments']
```
#[Route] 必须写在 public 方法上，且该方法不能是 static；路径参数如 {id} 对应的形参必须带类型声明（如 int $id），否则容器拒绝注入

Twig 模板里 dump() 不显示，或报 VariableDoesNotExist

7.2 默认禁用 dump() 和开发专用函数，避免误入生产环境。这不是 Twig 配置问题，而是环境开关控制。

确保 .env 中 APP_ENV=dev，且没有被 .env.local 覆盖
检查 config/packages/dev/twig.yaml 是否包含：
```
twig:
    debug: true
    strict_variables: true
```
{{ dump(user) }} 只在 dev 环境生效；若想在模板中安全访问嵌套属性，用 {{ user?.email }}（空合并操作符），而不是 {{ user.email }} —— 后者在 user 为 null 时直接抛异常