在 Symfony 中读取请求头应通过 Request 对象的 headers 属性，支持大小写不敏感获取、默认值 fallback 和多值处理；控制器中直接注入 Request，服务中需用 RequestStack 安全访问。
在 Symfony 中读取请求头，核心是通过 Request 对象的 headers 属性。它提供统一、类型安全的接口，支持大小写不敏感获取、多值处理和默认值 fallback，不依赖超全局数组。
直接从控制器方法中获取请求头
最标准的方式是将 Request 对象作为参数注入控制器动作方法，Symfony 自动解析并传入当前请求：
- 用
$request->headers->get('Authorization')获取单个头值（自动转小写匹配，'authorization'、'AUTHORIZATION'效果一致） - 支持默认值：
$request->headers->get('X-Api-Key', 'default-key') - 检查是否存在：
$request->headers->has('Content-Type') - 注意：返回值始终是字符串或
null；若头含多个值（如Set-Cookie），get()只返回第一个
读取含多个值的请求头（如 Set-Cookie、Accept）
某些头字段允许重复出现（HTTP 规范允许），Symfony 将其内部存储为数组。此时需用 all() 或显式索引：
- 获取全部值：
$cookies = $request->headers->get('Set-Cookie');→ 返回第一个 Cookie 字符串 - 获取所有同名头值：
$allCookies = $request->headers->get('set-cookie');（小写键）→ 实际等价于$request->headers->all()['set-cookie'] ?? [] - 更清晰写法：
$request->headers->all()['set-cookie'] ?? []，确保拿到完整数组
把所有请求头转成简单键值对数组
调试或日志记录时，常需扁平化头信息。headers->all() 返回的是「键→字符串数组」结构，可快速转换为「键→逗号分隔字符串」：
$headersArray = [];foreach ($request->headers->all() as $key => $values) {$headersArray[$key] = implode(', ', $values);}- 结果示例：
['content-type' => 'application/json', 'x-request-id' => 'abc123']
在无 Request 上下文时安全访问（如命令行或异步任务）
控制器内直接注入 Request 是安全的，但服务类、事件监听器或命令中不能硬依赖。应使用 RequestStack：
- 在服务中声明依赖：
public function __construct(private RequestStack $requestStack) {} - 获取当前请求：
$request = $this->requestStack->getCurrentRequest(); - 加空值判断：
if (null !== $request) { $token = $request->headers->get('X-Auth-Token'); } - 避免在 CLI 环境下因无请求而抛出异常
