Symfony 5.4+推荐直接在控制器方法签名中声明Request参数以自动注入请求对象，需置于路由参数之后；服务类中须用RequestStack获取，不可构造函数注入或属性存储。
直接在控制器方法签名里声明 Request 类型参数，就能拿到完整请求对象——这是 Symfony 5.4+（及大多数现代版本）最干净、最推荐的方式，不用调 $this->getRequest()，也不用依赖 $this->container。
控制器方法里怎么写 Request 参数
把 Request 当作普通函数参数加进去就行，Symfony 自动注入当前请求实例：
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
public function show(Request $request, int $id): Response
{
$name = $request->query->get('name'); // GET 参数
$email = $request->request->get('email'); // POST 表单参数
$json = $request->getContent(); // 原始 JSON 字符串（需自己 json_decode）
$files = $request->files->all(); // 上传文件
return new Response("ID: {$id}, Name: {$name}");
}
-
Request必须放在方法签名靠前位置（路由参数之后），否则类型解析可能失败 - 如果用了属性路由（
#[Route]），Request参数可以和路由变量（如$id）混用，顺序无关紧要，但建议把Request放最后，更符合直觉 - 不支持在构造函数里注入
Request—— 它不是容器级服务，每次请求都不同
query、request、attributes 三个参数池的区别
很多人混淆这三块数据来源，其实它们对应不同 HTTP 层次：
-
$request->query->all()：URL 查询字符串（?foo=bar&page=2），等价于$_GET -
$request->request->all()：POST/PUT 表单数据（application/x-www-form-urlencoded或multipart/form-data），等价于$_POST -
$request->attributes->all()：路由解析出的动态参数（如/user/{id}中的$id），也包含控制器元信息（_controller,_route等），不是用户传的请求数据
别误用 attributes 去取前端传的字段——它里面没有 name 或 email，只有路由和框架内部塞进去的东西。
安全获取参数：get() vs getInt() vs getBoolean()
别直接用 $_GET['page'] 风格硬取，Request 提供了带类型转换和默认值的安全方法：
-
$request->query->get('page', 1)→ 返回字符串，默认为"1" -
$request->query->getInt('page', 1)→ 强制转整数，默认为1（即使传了page=abc也会返回1） -
$request->query->getBoolean('active')→ 把1、true、on、yes都转成true - 所有方法都接受第二个参数作为 fallback，默认值在参数缺失或类型转换失败时生效
注意：如果必须确保参数存在且合法，应配合验证器（ValidatedDTO 或 FormType），而不是只靠 get* 方法兜底。
在服务类里需要 Request 怎么办
控制器里能直接写 Request 参数，但自定义服务类不行——服务默认是单例，不能持有 request-scoped 对象。正确做法是注入 RequestStack：
use Symfony\Component\HttpFoundation\RequestStack;
class MyService
{
public function __construct(private RequestStack $requestStack) {}
public function getCurrentUri(): string
{
$request = $this->requestStack->getCurrentRequest();
if (!$request) {
throw new \LogicException('No active HTTP request');
}
return $request->getUri();
}
}
- 永远不要在构造函数里调
$this->requestStack->getCurrentRequest()—— CLI 或异步任务中它可能是null - 不要把
Request存为类属性（$this->request = $request），会导致跨请求污染 - 如果只是偶尔用，也可以在方法里用全局
request()辅助函数（但不如RequestStack显式、可测试）
真正容易被忽略的是：很多开发者以为“只要能拿到 Request 就万事大吉”，却没意识到它在服务类里必须通过 RequestStack 按需获取，否则上线后会在并发或 CLI 场景下静默出错。
