PHP 8.1 中 header() 用法不变，但强调响应头命名须符合 RFC 7230 规范（如 Content-Type），否则 CDN、WAF 或 HTTP/2 环境下易失效；需避免前置输出、合理处理重复头、跳转后加 exit，并推荐封装或使用框架响应类。
PHP 8.1 中 header() 函数的用法与之前版本一致，核心逻辑没变，但对响应头规范性和安全性要求更高。关键不是“能不能设”，而是“怎么设才合规、稳定、可维护”。
必须遵守的格式规范
HTTP 协议（RFC 7230）明确要求响应头字段名采用“首字母大写、后续单词首字母大写、其余小写”的规范写法（canonical capitalization），比如：
-
✅ 正确：
Content-Type、Cache-Control、Set-Cookie、Location -
❌ 不推荐：
content-type、CONTENT-TYPE、cache_control
虽然 PHP 原生 header() 不校验大小写，浏览器也常能容错识别，但在 CDN（如 Cloudflare）、负载均衡器（如 AWS ALB）、WAF 或 HTTP/2 环境下，非规范写法易被静默丢弃或直接返回 502 错误。
常见响应头设置示例
以下写法均符合 PHP 8.1 最佳实践：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 指定内容类型：
header('Content-Type: application/json; charset=utf-8'); - 强制下载文件：
header('Content-Disposition: attachment; filename="report.pdf"'); - 禁用缓存：
header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0'); - 设置跨域（简单场景）：
header('Access-Control-Allow-Origin: https://example.com'); - 301 永久跳转：
header('HTTP/1.1 301 Moved Permanently'); header('Location: https://new-site.com/path');
容易出错的细节提醒
这些不是语法错误，但会导致 header 失效或行为异常：
- 调用
header()前不能有任何输出——包括空格、BOM 字节、echo、print，甚至未声明的 HTML 标签前的换行 - 多个同名 header（如重复设
Set-Cookie）会被合并，但顺序敏感；建议用headers_sent()检查是否已发送 - 若需覆盖已有 header（如修改
Content-Type），需加第三个参数true：header('Content-Type: text/plain', true, 200) - 跳转类 header（如
Location）后务必跟exit或die，否则后续代码仍会执行
更安全的封装建议
为避免手写错误，可在项目中统一封装：
- 定义常量：
define('HEADER_CONTENT_TYPE', 'Content-Type');，然后用header(HEADER_CONTENT_TYPE . ': ...') - 封装函数：
function set_header($key, $value) { header(ucwords(strtolower($key)) . ': ' . $value); }（仅作基础归一化，不替代人工校验） - 在框架（如 ThinkPHP）中优先使用其响应类（
Response::create()->header(...)），它内部已做大小写标准化处理
