thinkphp 6 中 $request->header() 是获取请求头的标准方法，返回小写键名的关联数组，支持大小写不敏感调用、默认值及空值 fallback；禁用直接数组访问和 server() 读取 http 头，需注意 nginx/apache/swoole 环境下自定义头的透传配置与命名规范。
ThinkPHP 6 的 Request 对象怎么取请求头
直接调用 $request->header()，它返回一个关联数组，键名自动转为小写（如 user-agent），值为原始头内容。不区分大小写传参也能取到，比如 $request->header('User-Agent') 和 $request->header('user-agent') 效果一样。
常见错误是误用 $request->server() 去查 HTTP_* 变量——虽然底层确实从 $_SERVER 读，但 ThinkPHP 6 已封装好逻辑，header() 才是标准、健壮的入口。
获取单个请求头字段的几种写法和区别
header() 支持多种调用方式，选哪种取决于你是否需要默认值或容错：
-
$request->header('content-type')：返回字符串，头不存在时返回null -
$request->header('content-type', 'application/json')：第二个参数是默认值，头缺失时返回该值 -
$request->header('content-type', '', 'text/plain')：第三个参数是“未设置时的 fallback”，仅当头存在但值为空时才生效（注意这个细节容易被忽略）
别用 $request->header()['Content-Type'] 这种数组访问方式——它会抛出 Notice（键不存在），且绕过了框架对空值/大小写的统一处理逻辑。
为什么在中间件里取不到某些请求头
典型现象：Nginx 或 Apache 反向代理后，X-Forwarded-For、X-Real-IP 等头能取到，但自定义头（如 X-Api-Key）始终为 null。
根本原因是 Web 服务器默认过滤掉带下划线的请求头。Nginx 需显式开启：underscores_in_headers on;；Apache 则需用 mod_headers + RequestHeader set 转发，不能只靠 ProxyPass。
另一个常见坑：Swoole 模式下，如果用 php think swoole 启动，默认不解析部分非标准头（尤其大写混合的），建议统一用小写命名自定义头，如 x-api-key 而非 X-Api-Key。
兼容 ThinkPHP 5.1 的写法要注意什么
TP5.1 的 Request 类没有 header() 方法，得用 $request->server('HTTP_X_TOKEN')，且键名必须带 HTTP_ 前缀、全大写、下划线分隔。
升级到 TP6 时最容易漏改的就是这部分代码。如果你的项目还在混用两个版本，建议封装一个兼容函数：
function getHeader($request, $key, $default = null) {
if (method_exists($request, 'header')) {
return $request->header($key, $default);
}
$serverKey = 'HTTP_' . strtoupper(str_replace('-', '_', $key));
return $request->server($serverKey, $default);
}
真正麻烦的不是语法差异，而是调试时忘记检查当前框架版本——同一个 $request 实例，在 TP5.1 下调 header() 会报 Call to undefined method，而 TP6 下用 server() 取头可能返回空，因为 HTTP_ 前缀规则不一致。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
