php获取请求header信息原来不难？这篇教程让你豁然开朗！

发布日期： 2025-10-10 阅读量： 作者： admin

好的，今天就来聊聊我之前搞PHP时怎么去拿请求里的header信息。这玩意儿，平时可能用得不多，但要做API接口或者需要验证点特殊信息的时候，就得跟它打交道了。

起初的尝试：直接翻 `$_SERVER`

刚开始嘛我也不太清楚有啥现成的法子。就想着PHP不是有个叫`$_SERVER`的全局变量么，里面存了一大堆服务器和请求的信息。那header这种东西，理论上应该也在里面？

于是我就先简单粗暴地用`var_dump($_SERVER);`把它整个打印出来瞅瞅。嚯，那家伙，信息是真不少，密密麻麻的。我耐着性子在里面找，果然发现了一些规律。

比如，我用工具（像Postman）或者前端代码里发的自定义header，假设叫`My-Custom-Token`，到了PHP这边，它就变成了`$_SERVER['HTTP_MY_CUSTOM_TOKEN']`。就是说，PHP会自动给你加上`HTTP_`前缀，然后把字母全变大写，再把短横线 `-` 给你换成下划线 `_`。标准的像`Content-Type`这种，它可能就是`$_SERVER['CONTENT_TYPE']`，不一定带`HTTP_`前缀。

行，知道这个规律了，那就可以干活了。写个循环，遍历`$_SERVER`这个大数组，然后判断一下键名是不是以`HTTP_`开头，或者是不是像`CONTENT_TYPE`这种特殊的，把它们挑出来，就拿到header了。稍微麻烦点的是，如果需要原始的`My-Custom-Token`这种格式，还得自己写代码把`HTTP_`去掉，下划线换回短横线，再调整下大小写。感觉有点笨拙，但确实是个法子。

发现新大陆：`getallheaders()` 函数

后来捣鼓多了，或者有时候搜点资料，就发现PHP提供了一个专门的函数叫`getallheaders()`。这名字一看就懂，获取所有头信息。

试了一下，真香！

直接`$headers = getallheaders();`，它就返回一个整理好的数组，键名就是原始的header名字，比如`My-Custom-Token`，值就是对应的值。简直不要太方便，省得我自己去`$_SERVER`里翻箱倒柜还做字符串替换了。

当时就觉得，以后就用这个了，简单明了。

踩了个坑：环境问题

高兴没多久，问题来了。我本地开发环境用的是Apache，`getallheaders()`跑得好好的。结果代码部署到服务器上，用的是Nginx + PHP-FPM，突然就报错了，说`getallheaders()`这个函数未定义！

我当时就有点懵，查了下才知道，原来`getallheaders()`这函数不是所有环境下都有的。它主要是Apache模块环境下才默认支持。在Nginx或者其他环境下，很可能就用不了。

这下可把我之前图省事的想法给打回去了。看来，只依赖`getallheaders()`是不靠谱的。

回归与改进：更通用的方法

没办法，还得回到最初的思路上来，就是从`$_SERVER`里手动提取。但这回不能像之前那么糙了，得弄个更稳定、更通用的方案。

我就想，能不能写个自己的函数，专门用来获取header。在这个函数里：

先检查`function_exists('getallheaders')`，看看这个方便的函数在当前环境下能不能用。
如果能用，那就直接调用`getallheaders()`返回结果，皆大欢喜。
如果不能用，那就执行备用方案：遍历`$_SERVER`。
在遍历的时候，主要关注那些以`HTTP_`开头的键名。
拿到这些键名后，进行处理：去掉`HTTP_`前缀，把下划线`_`替换回短横线`-`。还有个细节，对于像`Content-Type`这种，原始header是首字母大写的，处理后也要变回去，不能是全大写或全小写。这个转换稍微要细心点，可以用`ucwords`配合`strtolower`来处理。
把处理好的键名和对应的值存到一个新数组里。
别忘了，还有些特殊的header可能不带`HTTP_`前缀，比如`CONTENT_TYPE`、`CONTENT_LENGTH`，也得单独判断一下加进去。
返回这个手动构建出来的header数组。

这样封装一下之后，代码就健壮多了。不管服务器环境怎么变，我调用自己写的这个函数，总能拿到想要的header信息，优先用高效的`getallheaders()`，不行就用兼容性好的`$_SERVER`提取法。

总结下

所以你看，获取PHP请求header这事儿，说简单也简单，`getallheaders()`一个函数搞定。但说它有坑，也确实有，就是这个函数的环境依赖性。我自己的实践过程就是从最基础的`$_SERVER`摸索，到发现便捷的`getallheaders()`，再到踩坑后回归`$_SERVER`并做了封装改进。最终的体会就是，写代码还是得考虑周全点，兼容性该做还是得做，尤其是在写一些可能被部署到不同环境下的功能时。自己封装一个兼容函数，虽然多写几行代码，但后面能省不少心。

上一篇: 在哪里能找到seo教程全集？这份完整版新手必看！

php获取请求header信息原来不难？这篇教程让你豁然开朗！

随便看看