PHP stream_context_create 怎样读取响应头

stream_context_create() 只创建请求配置，本身不发送请求，也不返回响应头。将它交给 fopen() 打开 HTTP/HTTPS 地址后，可以从同一流句柄的 stream_get_meta_data() 结果里读取 wrapper_data。其中通常是包含状态行和响应头的字符串数组，发生重定向时可能包含多个响应段。

一个常见场景是后台需要显示远端接口的状态和内容类型，却把 context 中的 header 当成服务器回传的头。本文把配置、原始响应行、结构化状态和界面提示分开，做成一个可改造的读取示例，不扩展为完整 HTTP 客户端。

PHP 官方地址：https://www.php.net/

先把请求配置与响应信息分开

context 的 HTTP 选项控制发出的请求；header 是请求头，content 是请求正文。响应头来自执行请求后的 HTTP 包装器。即使 URL 是 HTTPS，请求方法和超时等选项仍放在 http 键下，TLS 参数才属于底层 SSL 配置。

先固定一个自己控制或确认允许访问的 HTTPS 地址。示例采用保留示例域名，不保证该域名的响应状态或头字段固定；接入业务时替换为自己的固定服务地址，不直接接收任意用户 URL。

用同一个流句柄读取响应头

下面面向 PHP 8.x，使用 GET 请求但不读取正文。为了先看清一个响应，显式关闭重定向。请求失败仍可能留下警告，应用应把它接入自己的日志；示例不使用 @ 隐藏诊断信息。

 [
        'method' => 'GET',
        'timeout' => 8.0, // 读取超时，不是整个业务操作的总截止时间。
        'follow_location' => 0, // 先观察单次响应，不自动跳转。
        'ignore_errors' => true, // 允许读取HTTP错误状态的响应，不等于业务成功。
    ],
]);

$stream = fopen($url, 'rb', false, $context);
if ($stream === false) {
    throw new RuntimeException('HTTP流未能打开，请查看网络与PHP日志');
}

try {
    $metadata = stream_get_meta_data($stream);
    $headerLines = $metadata['wrapper_data'] ?? [];
    if (!is_array($headerLines)) {
        throw new RuntimeException('当前包装器没有提供响应头数组');
    }
    // 复制当前流的原始响应行；下面的解析代码使用这个变量。
    $rawHeaders = array_values($headerLines);
} finally {
    fclose($stream); // 不读取正文时也必须释放句柄。
}

不能在 fopen() 返回 false 时继续读取元数据，也不能对失败值调用 fclose()。成功取得句柄后用 finally 释放资源，响应行数组已经保存，不依赖句柄继续打开。

按状态行拆开多段响应

不要固定读取数组第零项作为最终状态。官方文档明确提醒，跟随重定向时，最前面的状态行可能对应前一跳。即使关闭跳转，也应让解析器能保存多段信息，而不是把所有字段压成一个表。

以下代码接在前例后。它按新的 HTTP 状态行建立一个响应段，将字段名转为小写，并把同名字段值保存为数组，避免重复字段被覆盖。此解析器面向常规包装器响应行，不是覆盖所有历史折行格式的通用协议解析库。

// 按状态行建立分组，保留每段响应的独立字段。
$blocks = [];
$current = -1;
foreach ($rawHeaders as $line) {
    if (!is_string($line)) {
        continue;
    }
    if (preg_match('~^HTTP/\\S+\\s+(\\d{3})(?:\\s|$)~i', $line, $match) === 1) {
        $blocks[] = [
            'status_line' => $line,
            'status' => (int) $match[1],
            'headers' => [],
        ];
        $current = count($blocks) - 1;
        continue;
    }
    if ($current = 200) {
        $final = $block;
    }
}
if ($final === null) {
    throw new RuntimeException('没有读到可判定的最终响应状态');
}
$status = $final['status'];
$contentTypes = $final['headers']['content-type'] ?? [];

例如一次跳转产生了前后两段，$blocks 会保留各自状态和字段；这只是数据结构说明，不是本文实际请求得到的输出。当前示例关闭跳转，所以遇到 3xx 就将它显示为待处理跳转，不会自行请求 Location。

如果业务确实需要跟随跳转，应另行明确目标域名和跳转策略，并保留整组响应段。只有请求正常完成，才能把最后的非 1xx 段当成候选最终响应；跳转超限或中途失败时，不能把已有的某个成功段误认作整项业务成功。

在业务界面呈现明确的状态

面向使用者的结果应区分“无法建立请求”“已收到 HTTP 状态”“仍需跳转”“业务拒绝”，不能统一显示成红色的请求失败。下面只展示状态和内容类型，不把 Cookie 等完整响应头倾倒到页面。

// 对远端文本进行HTML转义，状态不用只靠颜色表达。
$label = match (true) {
    $status >= 200 && $status  '已收到成功状态',
    $status >= 300 && $status  '收到跳转状态，尚未跟随',
    $status >= 400 && $status  '远端拒绝或资源不可用',
    default => '远端返回其他状态，请查看日志',
};
$typeText = implode(' / ', $contentTypes);
echo '
', htmlspecialchars($label, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'),
     '（HTTP ', $status, '）
';
echo '
Content-Type：',
     htmlspecialchars($typeText === '' ? '未提供' : $typeText,
         ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'),
     '
';

在界面里保留明确文字和状态码；错误区域应有可读文本，不能只依赖图标、颜色或弹出后立即消失的提示。HTTP 的 2xx 也只说明协议层状态，是否满足业务规则还要结合响应内容；本文没有读取和判定正文。

选择其他入口时注意版本和作用域

若已使用 file_get_contents() 并希望读取最近响应头，PHP 8.4 起提供 http_get_last_response_headers()，没有可用信息时返回 null。与句柄元数据不同，它表达最近的 HTTP 包装器响应，发起另一次请求会影响“最近”的含义。

在使用该入口的独立实现中，应先用 http_clear_last_response_headers() 清理之前保存的头，请求后立即读取，避免失败后误取上一次信息。不要为了拿头再次调用 get_headers()，那是另一项网络请求，状态可能已经变化。

旧代码常用 $http_response_header，它在请求发生的局部作用域创建，函数内部请求不会替外部自动生成同名变量。该变量从 PHP 8.5 起被弃用，新代码不要继续以它作为首选方案。本文主例采用句柄元数据，避免在跨版本示例里混用几种读取来源。

处理超时、空正文与大响应

主例使用 GET 以观察这个请求对应的响应头，未读正文并不等于远端完全没有发送正文。若目标接口明确支持 HEAD，可按契约调整方法；不要假设 HEAD 与 GET 的实际行为和字段永远一致。若后续需要读正文，应限制读取量并单独处理超时或失败，避免把大响应一次性放进内存。超时选项也不等于整个应用操作有精确的八秒总耗时上限。

创建 context 后为什么没有响应头？

因为尚未执行请求。context 是输入配置，只有 HTTP 包装器实际收到响应后，才可能得到响应信息。

HTTPS 地址需要把 http 改成 https 吗？

方法、请求头等 HTTP 选项仍用 http 分组；TLS 选项与此分开。

headers_list() 能读取远端响应头吗？

它处理当前脚本准备发给客户端的响应头，不是本例的远端 HTTP 包装器元数据，不能互换。

参考：HTTP context 选项、流元数据、最近响应头、清理最近响应头、旧响应头变量。