PHP header() 函数完全指南：语法、参数与常用场景详解

header() 函数的核心作用与底层逻辑

header() 是 PHP 用于直接发送原始 HTTP 响应头到客户端的关键函数。它允许开发者在 HTTP 协议层面精确控制交互细节，包括定义响应状态、管理浏览器缓存、处理跨域请求（CORS）以及控制文件下载行为。

调用前提与常见错误排查

由于 HTTP 头部必须在响应体（HTML、JSON 等实际内容）之前发送，header() 的调用具有严格的顺序限制：

• 零输出原则：在调用 header() 之前，脚本不能有任何实际输出，包括空格、换行符或 BOM（字节顺序标记）。若违反此规则，将触发 Cannot modify header information - headers already sent 警告。
• 解决措施：利用 PHP 的输出缓冲机制（Output Buffering），在脚本顶部使用 ob_start(); 或在 Apache/Nginx 配置中开启 OutputBuffering On。

一、语法结构及参数详解

bool header(string $header, bool $replace = true, int $http_response_code = null)

第 1 步：理解核心参数

第 2 步：掌握参数交互逻辑

• 显式状态码优先：当 $header 以 HTTP/ 开头（例如 'HTTP/1.1 404 Not Found'）时，第三参数 $http_response_code 将被忽略。
• 重复头控制：对于需要保留多个相同名称头信息的场景（如并发设置多个 Cookie），必须将第二个参数设为 false。

二、核心应用场景：重定向、状态码与内容类型

第 3 步：实现页面重定向（Redirect）

这是 header() 最常用的功能，通过 Location 头告诉浏览器跳转至新 URL。执行后务必使用 exit 终止脚本，防止后续代码意外执行。

• 临时重定向（默认 302）：
  header('Location: https://example.com'); exit;
• 永久重定向（301 Moved Permanently）：
  适用于网站改版或域名变更。
  header('Location: https://new.example.com', true, 301); exit;

第 4 步：声明 HTTP 状态码（Status Codes）

显式修改响应状态码，向搜索引擎和客户端反馈准确的请求结果：

• 404 未找到：header("HTTP/1.1 404 Not Found");
• 500 服务器错误：header("HTTP/1.1 500 Internal Server Error");
• 304 未修改（配合 If-Modified-Since 使用）：header("HTTP/1.1 304 Not Modified");

第 5 步：控制内容类型（Content-Type）

告知客户端如何解析返回的数据，避免乱码或渲染错误：

• 返回 JSON 数据（API 开发常用）：
  header('Content-Type: application/json');
• 声明 HTML 页面编码：
  header('Content-Type: text/html; charset=utf-8');
• 触发文件下载：
  通过 Content-Disposition 结合 Content-Type 实现：
  header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="report.pdf"');

三、高级控制：缓存策略与安全设置

第 6 步：精细化缓存控制

通过 Cache-Control 和 Expires 减少带宽消耗并优化性能：

• 禁用缓存（适合动态敏感数据）：
  header('Cache-Control: no-cache, must-revalidate');
header('Expires: Mon, 26 Jul 1997 05:00:00 GMT'); // 兼容旧版浏览器的过去时间
• 长期缓存（适合静态资源）：
  使用较远的未来时间设定过期：
  header('Cache-Control: max-age=31536000, public');

第 7 步：配置跨域与认证头

• CORS 跨域资源共享（允许前端不同域名访问）：
  header('Access-Control-Allow-Origin: *'); // 生产环境建议指定具体域名而非 *
• Basic 身份认证：
  配合 401 状态码返回认证提示：
  header('WWW-Authenticate: Basic realm="Secure Area"');
header('HTTP/1.1 401 Unauthorized');

四、查看与分析 HTTP 响应头

在开发调试过程中，验证 header() 是否正确发出至关重要：

1. 浏览器开发者工具（推荐）：按 F12 打开工具 → 切换到 Network（网络）面板 → 刷新页面并点击对应请求 → 在 Headers 标签页底部的 Response Headers 区域查看实际发出的头部信息。
2. cURL 命令行提取：在终端执行 curl -I https://example.com，该命令只获取 HTTP 头部而不下载内容。

总结

以上就是对 PHP header() 函数从基础语法到高频应用场景的详细内容，更多关于 HTTP 协议交互与 Web 性能优化的资料请关注本站其它相关文章！