如何使用 headers_list() 查看当前已设置的 HTTP 头信息清单？

M66 2025-07-04

在 PHP 中，headers_list() 函数是一个非常有用的工具，用于查看当前脚本中已经设置的所有 HTTP 头信息。它返回一个数组，包含了所有 HTTP 头的名称和对应的值。这对于调试 HTTP 头的设置，尤其是在发送前检查某些头是否正确设置时，显得尤为重要。

基本用法

headers_list() 函数不接受任何参数。当你调用它时，它会返回一个包含所有已发送 HTTP 头信息的数组。这里有一个基本示例，演示如何使用 headers_list() 函数：

<?php
// 设置一些 HTTP 头
header('Content-Type: application/json');
header('Cache-Control: no-cache');

// 获取当前已设置的所有 HTTP 头
$headers = headers_list();

// 输出所有头信息
foreach ($headers as $header) {
    echo $header . "<br>";
}
?>

在上面的示例中，我们首先使用 header() 函数设置了两个 HTTP 头：Content-Type 和 Cache-Control。然后，通过调用 headers_list()，我们获取了当前所有设置的 HTTP 头，并逐一输出。

输出示例

当你运行上面的代码时，输出可能类似于：

Content-Type: application/json
Cache-Control: no-cache

注意事项

头信息发送顺序：headers_list() 返回的头信息是按照发送的顺序排列的。这意味着，如果你在脚本中先后设置了多个相同类型的头，headers_list() 会显示出这些头，并且顺序是按照它们被设置的先后进行排列的。
必须在输出前调用：请注意，headers_list() 只能在没有任何输出之前调用。PHP 会在输出任何内容到浏览器之前发送 HTTP 头，因此，如果在调用 headers_list() 前已经有输出（如 echo 或 HTML 代码），你将无法获取到头信息。

设置自定义 HTTP 头

如果你需要设置自定义的 HTTP 头信息并查看它们，可以使用类似以下的代码：

<?php
// 设置一个自定义的 HTTP 头
header('X-Custom-Header: m66.net');

// 获取当前的 HTTP 头
$headers = headers_list();

// 输出所有头信息
foreach ($headers as $header) {
    echo $header . "<br>";
}
?>

在这个例子中，我们设置了一个名为 X-Custom-Header 的自定义头，值为 m66.net。通过 headers_list()，我们可以查看它是否已被成功设置。

其他相关函数

除了 headers_list()，PHP 还有其他一些相关的函数可以帮助你操作和管理 HTTP 头：

header()：用于发送一个原始的 HTTP 头到浏览器。
headers_sent()：检查是否已经发送了 HTTP 头。

这些函数的结合使用可以帮助你灵活地控制 HTTP 头的行为，确保数据正确地传输给客户端。