PHP header() 函数的基础用法详解

M66 2025-05-18

PHP的header()函数是一个非常常用的函数，它用于发送原始的HTTP头信息到客户端浏览器。通过这个函数，开发者可以控制页面响应的头部信息，从而影响浏览器的行为。例如，可以用它来设置重定向、修改内容类型、控制缓存等。

一、header()函数的基本用法

header()函数的基本语法如下：

header(string $header, bool $replace = true, int $response_code = 0): void

$header：要发送的HTTP头信息。
$replace：指示是否替换之前的同类型的头信息，默认为true，表示替换；如果为false，则会追加新的头信息。
$response_code：HTTP响应码，例如200表示成功，301表示永久重定向，404表示未找到页面等。

例子：

header("Content-Type: application/json"); // 设置响应的内容类型为JSON
header("Location: http://m66.net/redirect-page"); // 发送301重定向头信息

二、header()函数的常见应用场景

页面重定向
header()函数最常见的应用之一是页面重定向。通过发送Location头，可以将用户重定向到另一个URL。例如：
```
header("Location: http://m66.net/newpage"); // 将用户重定向到新的页面
exit(); // 确保脚本停止执行，避免继续输出内容
```
在此示例中，当访问该页面时，浏览器会被引导到http://m66.net/newpage。
设置内容类型
可以使用header()函数来设置响应的内容类型。例如，如果您要返回JSON数据给前端，您可以设置Content-Type头信息为application/json：
```
header("Content-Type: application/json");
echo json_encode(["message" => "Hello, world!"]);
```
这告诉浏览器，返回的数据是JSON格式，而不是HTML或其他类型。
控制缓存
使用header()函数，您可以控制浏览器是否缓存某些页面内容。例如，禁用页面缓存：
```
header("Cache-Control: no-store, no-cache, must-revalidate");
header("Pragma: no-cache");
header("Expires: 0");
```
这会告诉浏览器每次都重新请求页面，而不使用缓存内容。
发送404错误页面
如果页面没有找到，可以通过设置HTTP状态码为404来告知浏览器这是一个“未找到”错误：
```
header("HTTP/1.1 404 Not Found");
echo "Page not found";
```
这使得浏览器能够正确处理404错误并展示错误页面。
避免直接访问某些文件
如果您希望防止用户直接访问某些敏感文件（如配置文件），可以通过header()函数检查访问来源并重定向用户。例如：
```
if ($_SERVER['HTTP_REFERER'] !== 'http://m66.net/safe-zone') {
    header("Location: http://m66.net/access-denied");
    exit();
}
```

三、使用header()时的注意事项

必须在输出前调用
header()函数需要在页面任何输出内容之前调用。如果页面已经输出了HTML或其他内容，就会导致“头信息已经发送”的错误。为了避免这种错误，建议在PHP代码开头就调用header()，并确保没有任何输出（包括空格或换行）。
```
// 错误的使用方法：
echo "Hello, World!";
header("Location: http://m66.net/newpage");  // 会报错

// 正确的使用方法：
header("Location: http://m66.net/newpage");  // 应该在任何输出之前
exit();
```
使用exit()终止脚本
在发送重定向后，通常会使用exit()函数停止脚本的继续执行，以避免之后的代码产生意外的输出。
```
header("Location: http://m66.net/newpage");
exit();
```
调试时检查header输出
如果您遇到“头信息已经发送”的错误，可以启用PHP的输出缓冲区，或者使用headers_sent()函数来调试：
```
if (headers_sent($file, $line)) {
    echo "Headers already sent in $file on line $line";
}
```
确保HTTP协议正确
在使用header()函数时，确保传递的HTTP头是符合协议的，比如，Location头后面需要跟有效的URL。

四、总结

header()函数是PHP中一个功能强大的工具，它能让我们在开发中控制浏览器行为、改变响应头、进行页面重定向等操作。掌握header()函数的正确使用方法，对于开发者在处理HTTP请求、响应和页面重定向等方面具有重要意义。

通过了解其基本用法和应用场景，你可以更好地控制浏览器与服务器之间的交互，提高网站的性能和用户体验。