直接用 $request->header() 获取标准化后的全部请求头，它返回关联数组且不区分大小写，比手动处理 $_SERVER 或 getallheaders() 更稳定可靠。
ThinkPHP里怎么拿到完整的请求Header
直接用 $request->header() 就能获取全部 Header，它返回一个关联数组，键是标准化后的 Header 名（比如 user_agent、content_type），值是对应值。这个方法不区分大小写，内部做了 HTTP_ 前缀剥离和下划线转驼峰的处理，所以别自己去 $_SERVER 里翻 HTTP_X_FORWARDED_FOR 这类原始键。
常见错误是以为必须手动遍历 $_SERVER 或用 getallheaders() —— 在 CLI 或某些 SAPI（如 PHP-FPM 配置不当）下，getallheaders() 可能不可用或返回空，而 $request->header() 是 ThinkPHP 自己兜底实现的，更稳。
- 在控制器中：直接注入
think\Request或用request()辅助函数 - 调试时可直接
dump($request->header())，比print_r($_SERVER)干净得多 - 注意：如果 Nginx 用了
underscores_in_headers off（默认），带下划线的自定义 Header（如X-Api-Key）会被丢弃，得改 Nginx 配置或改用短横线
为什么 $request->header('X-Token') 返回空
不是代码写错了，大概率是 Web 服务器没把那个 Header 透传给 PHP。ThinkPHP 的 header() 方法本身没问题，但它的数据源依赖于 SAPI 层提供的环境变量。
典型场景：Nginx 反向代理时，默认不转发带下划线的 Header；Apache 的 mod_rewrite 有时会过滤；Swoole Server 则完全依赖你启动时是否启用 enable_http2 或是否手动设置了 http_parse 行为。
立即学习“PHP免费学习笔记（深入）”；
- Nginx 中需显式添加：
proxy_set_header X-Token $http_x_token;（注意变量名要小写+下划线） - Apache 需确认
mod_headers已启用，并用RequestHeader set X-Token "%{HTTP:X-Token}e" - Swoole 下，确保
server->set(['http_compression' => false])不影响 Header 解析，且客户端发的是标准格式（如X-Token: abc123，不是x_token）
调试时想看原始 Header 和 Request 对象全貌
光看 $request->header() 有时不够，比如要确认某个 Header 是被框架覆盖了，还是压根没收到。这时候得绕过封装，直连底层数据源。
ThinkPHP 的 think\Request 实例在初始化时会缓存 $_SERVER 和解析结果，但你可以用 $request->server() 查看原始 $_SERVER 数组，重点盯 HTTP_* 开头的键；或者用 $request->getHeaders()（5.1+）——它等价于 getallheaders() 的安全封装，失败时会 fallback 到扫描 $_SERVER。
-
$request->server()返回完整$_SERVER，适合查REQUEST_METHOD、QUERY_STRING等非 Header 字段 -
$request->getHeaders()更接近“原始 Header”，但注意：它不会自动转换键名（比如仍是X-Token而非x_token） - 如果用
dump($request)，会触发魔术方法，输出大量内部属性，容易干扰判断，建议只 dump 具体方法返回值
自定义 Header 名称在不同版本中的兼容性
ThinkPHP 5.0 和 6.x 对 Header 键名的规范化逻辑不同：5.0 把 X-Real-IP 转成 x_real_ip，6.x 默认转成 xRealIp（驼峰）。如果你写了 $request->header('x_real_ip')，在 6.x 下会失效。
这不是 bug，是设计变更。官方建议统一用短横线风格调用，比如 $request->header('x-real-ip')，框架内部会自动适配。但实际测试发现，部分旧模块（如中间件里提前读取）可能仍按旧规则走，导致不一致。
- 稳妥写法：始终用短横线分隔的字符串作为参数，如
'x-forwarded-for'，不要用下划线或驼峰 - 5.0 升级到 6.x 时，全局搜
->header(，把所有下划线写法替换成短横线 - 如果必须兼容双版本，封装一个工具函数，内部根据
think_version()分支处理
Header 的大小写敏感性、Web 服务器透传策略、框架版本间的键名归一化逻辑——这三者叠在一起，才是最常出问题的地方。别急着改代码，先确认 Header 到没到 PHP 进程里。
