ThinkPHP中Request的header方法_获取自定义请求头信息【操作】-ThinkPHP-PHP中文网

能，但需请求头名符合http规范且未被服务器过滤；request::header('x-user-id')返回空的主因是nginx默认丢弃含下划线的头、apache安全模块拦截或前端传参格式不标准，其参数不区分大小写但会标准化为小写短横线匹配。

thinkphp中request的header方法_获取自定义请求头信息【操作】

ThinkPHP 的 `Request::header()` 能否获取自定义请求头？

能，但前提是请求头名必须符合 HTTP 头命名规范（字母、数字、短横线），且服务端未被 Web 服务器（如 Nginx/Apache）过滤或重写。常见失败不是框架问题，而是中间件或服务器配置截断了自定义头。

为什么 `Request::header('X-User-Id')` 返回空？

有三个高频原因：

Nginx 默认会忽略下划线（_）开头或含下划线的请求头，比如 X_User_Id 会被直接丢弃 —— 改用短横线格式 X-User-Id 并在 Nginx 配置中添加 underscores_in_headers on;
Apache 的 mod_security 或某些安全模块会拦截非常规头名，可临时关闭验证确认是否为此原因
前端发请求时用了驼峰（xUserId）或全大写（XUSERID），而 ThinkPHP 的 header() 方法内部做了标准化处理（转为小写+短横线），需严格按标准格式传入键名

`Request::header()` 的参数行为与大小写敏感性

该方法对键名不区分大小写，但匹配逻辑是“标准化后精确匹配”：它会把输入的 $name 转成小写并把下划线转为短横线，再和服务器实际收到的头名比对。所以以下调用等效：

Request::header('X-User-Id');
Request::header('x-user-id');
Request::header('X_USER_ID'); // ⚠️ 注意：这个会被转成 x-user-id，但若原始请求头是 X_USER_ID，Nginx 已丢弃，实际取不到

建议始终用短横线风格传参，避免歧义。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

如何调试真实接收到的请求头？

不要只信前端日志或浏览器 Network 面板 —— 中间层可能已修改。最可靠方式是在控制器里 dump 原始头：

dump($_SERVER);
// 或更精准地提取所有 HTTP_* 变量
$headers = [];
foreach ($_SERVER as $key => $value) {
    if (strpos($key, 'HTTP_') === 0) {
        $headers[str_replace('_', '-', strtolower(substr($key, 5)))] = $value;
    }
}
dump($headers);

对比 Request::header() 和这里输出的差异，就能定位是框架没读到，还是根本没进 PHP 环境。

真正卡住的地方往往不在 ThinkPHP 本身，而在 Nginx 的 underscores_in_headers 默认关着，或者开发环境用的内置 PHP Server 完全不支持自定义头转发 —— 这些细节不查 $_SERVER 很难发现。