必须调用 getValue() 才能获取真实 header 值，因 $this->request->headers() 返回的是 Header 对象数组而非原生键值对，直接打印或 isset 判断会误判为空。
直接用 $this->request->headers() 拿不到原始值，必须调用 getValue() 才能取出真实 header 字符串。
为什么 $this->request->headers() 返回的数组看起来是空的
CodeIgniter 4 的 $this->request->headers() 返回的是 CodeIgniter\HTTP\Header 对象数组，不是 PHP 原生的键值对。直接 print_r() 或 var_dump() 看到的是对象结构，里面字段被封装了，value 属性不可见，所以容易误判为“空”。
- 常见错误现象：打印
$this->request->headers()后看到一堆object(CodeIgniter\HTTP\Header)#...，但isset($headers['X-Shopify-Hmac-Sha256'])返回 false，或取值为null - 根本原因：框架做了封装，避免用户误操作（比如重复设置、大小写冲突），但代价是必须显式调用方法提取
- 不兼容场景：Shopify Webhook、Stripe webhook、自定义反向代理头（如
X-Forwarded-For）等依赖特定 header 的集成，最容易踩这个坑
正确提取所有请求头值的两种写法
核心动作就一个：foreach 遍历 + $header->getValue() 取值。下面两个写法效果一致，选可读性高的那个即可。
- 基础写法（推荐新手）：
$headers = $this->request->headers(); $headerValues = []; foreach ($headers as $key => $header) { $headerValues[$key] = $header->getValue(); } // 此时 $headerValues['X-Shopify-Hmac-Sha256'] 就是真实字符串 - 简洁写法（适合已有经验）：
$headers = $this->request->headers(); $headerValues = array_map(fn($h) => $h->getValue(), $headers);
- 注意：
array_walk不推荐——它不返回新数组，需额外初始化变量，反而更绕
获取单个 header 值的快捷方式（慎用）
框架提供了 $this->request->getHeaderLine('X-Forwarded-For')，但它有隐藏限制：
- 只返回第一个匹配的 header 值（HTTP 允许多个同名 header，但 CI4 默认只取首个）
- 对大小写不敏感，但某些代理（如 Nginx）可能严格区分大小写，导致漏匹配
- 如果 header 名含下划线（如
X_Custom_Id），部分服务器会自动转成破折号（x-custom-id），而getHeaderLine()默认按原始传入名查找，可能失败 - 真正要校验签名（如 Shopify HMAC）时，必须用上面的遍历+
getValue()方式，确保拿到原始未处理的值
容易被忽略的底层细节
CI4 的 header 解析依赖 apache_request_headers() 或 getallheaders()，但在 CLI 环境、FastCGI、或某些容器部署中这些函数可能不可用，导致 $this->request->headers() 返回空对象数组。
- 验证方式：在控制器里加一行
var_dump(function_exists('apache_request_headers')); - 补救办法：若函数不存在，可手动从
$_SERVER提取，例如$_SERVER['HTTP_X_SHOPIFY_HMAC_SHA256']（注意HTTP_前缀 + 大写 + 下划线替换） - 安全提醒：不要直接信任
$_SERVER中的 header，尤其涉及鉴权时，应优先走框架封装层，仅作 fallback
