php curl获取header

⚡ PHP cURL获取Header核心原理详解

在PHP网络编程中,php curl获取header是实现HTTP协议级调试、接口鉴权验证、响应头分析的必备技能。cURL(Client URL)作为PHP内置的网络请求扩展,其灵活性与强大功能使其成为开发者首选的HTTP客户端工具。然而,初学者常陷入“无法分离响应体与响应头”的困境,或误以为curl_exec()直接返回完整HTTP响应内容。

实际上,php curl获取header需通过curl_setopt()设置特定选项,明确指定“是否需要响应头”、“如何存储响应头”、“是否与响应体分离”等行为。核心机制在于:cURL默认将响应头与响应体合并返回;若启用CURLOPT_HEADER选项,则响应头会前置拼接在响应体前;若使用CURLOPT_HEADEROPT为CURLHEADER_SEPARATE,则响应头可通过curl_getinfo()单独获取;而CURLHEADER_UNIFIED则为默认合并模式。

在真实业务场景中,php curl获取header需求主要集中在以下场景:① 解析Content-Type判断返回数据格式;② 检查X-RateLimit-Remaining监控API调用频次;③ 验证Set-Cookie是否成功设置会话;④ 分析Location实现自动重定向;⑤ 读取ETag与Last-Modified实现条件请求。忽略响应头信息,可能导致缓存失效、鉴权失败、资源重复下载等严重问题。

值得注意的是,HTTP/2协议引入了头部压缩(HPACK),而cURL 7.33.0+版本已原生支持HTTP/2,此时响应头以二进制帧形式传输,需依赖curl_getinfo()的CURLINFO_HEADER_SIZE字段计算偏移量再截取原始头内容。因此,php curl获取header不仅是API调用问题,更涉及HTTP协议层的深度理解与适配策略。

⚙️ 三大主流获取Header方法对比

〔1〕

方法一:启用CURLOPT_HEADER + 手动分割

最基础的方案是启用curl_setopt($ch, CURLOPT_HEADER, true),使响应头与响应体合并返回,再通过字符串分割提取头信息。关键点在于:响应头与响应体之间以连续两个换行符(\r\n\r\n)分隔;HTTP响应体可能包含换行符,需避免误分割。

<?php
$ch = curl_init('https://www.example.com/api');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true);
$response = curl_exec($ch);
$info = curl_getinfo($ch);
// 分割点:查找第一个\r\n\r\n位置
$splitPos = strpos($response, "\r\n\r\n");
if ($splitPos !== false) {
    $headersRaw = substr($response, 0, $splitPos);
    $body = substr($response, $splitPos + 4); // 跳过分隔符
} else {
    $headersRaw = '';
    $body = $response;
}
curl_close($ch);
// 解析为关联数组
$headers = [];
foreach (explode("\r\n", $headersRaw) as $line) {
    if (strpos($line, ':') !== false) {
        list($key, $value) = explode(':', $line, 2);
        $headers[trim($key)] = trim($value);
    }
}
?>

此方案优势在于兼容性极强(PHP 4+可用),但存在局限:① 若响应体以\r\n\r\n开头(罕见但可能),分割会失败;② 无法区分重复Header(如多个Vary);③ 对二进制响应体(如图片)可能误判分隔符。建议配合CURLINFO_HEADER_SIZE校验偏移量增强鲁棒性。

〔2〕

方法二:使用CURLOPT_HEADEROPT分离模式

自cURL 7.36.0起(PHP 5.6.0+支持),CURLOPT_HEADEROPT选项提供更优雅的解决方案。设置curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE)后,响应头会以数组形式存储在curl_getinfo($ch, CURLINFO_HEADER)中,响应体则独立返回。

<?php
$ch = curl_init('https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE); // 关键!
curl_setopt($ch, CURLOPT_HEADER, false); // 可选,避免重复
$response = curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER); // 数组格式
$body = $response;
curl_close($ch);
// 示例:获取特定Header
$contentType = $headers['Content-Type'] ?? '';
$rateLimit = $headers['X-RateLimit-Remaining'] ?? 'unknown';
?>

该方案优势显著:① 响应头自动解析为关联数组;② 重复Header自动合并为数组(如$headers['Set-Cookie']包含所有Cookie);③ 无分割误判风险;④ 与HTTP/2兼容性更好。但需注意:PHP版本需≥5.6.0,且cURL库版本需≥7.36.0(可通过curl_version()检查)。

〔3〕

方法三:自定义Header回调函数

最高级方案是利用CURLOPT_HEADERFUNCTION回调,实时捕获每一行响应头。此方法适合需要实时处理Header(如下载进度监控、流式Header解析)的场景,但实现复杂度较高。

<?php
class HeaderParser {
    public $headers = [];
    public $headerLines = [];
    public function parseHeader($ch, $line) {
        $line = trim($line);
        if ($line === '') return strlen($line); // 空行结束
        $this->headerLines[] = $line;
        if (strpos($line, ':') !== false) {
            list($key, $value) = explode(':', $line, 2);
            $key = trim($key);
            $value = trim($value);
            // 处理重复Header
            if (isset($this->headers[$key])) {
                if (is_array($this->headers[$key])) {
                    $this->headers[$key][] = $value;
                } else {
                    $this->headers[$key] = [$this->headers[$key], $value];
                }
            } else {
                $this->headers[$key] = $value;
            }
        }
        return strlen($line);
    }
}
$parser = new HeaderParser();
$ch = curl_init('https://api.example.com/status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADERFUNCTION, [$parser, 'parseHeader']);
$response = curl_exec($ch);
$headers = $parser->headers; // 完整Header数组
curl_close($ch);
// 示例:获取所有Cookie
$cookies = $headers['Set-Cookie'] ?? [];
?>

此方案优势在于:① 实时处理,无内存积压;② 支持自定义解析逻辑;③ 可同步记录Header时间戳用于性能分析。劣势是需额外处理空行、状态行(如HTTP/1.1 200 OK),且回调函数需返回处理字节数以避免cURL中断。

核心对比表

方案 兼容性 重复Header支持 HTTP/2适配 适用场景
手动分割 PHP 4+ ❌ 仅保留最后一个 ⚠️ 需校验偏移量 简单脚本、低版本环境
CURLOPT_HEADEROPT PHP 5.6.0+ ✅ 自动合并数组 ✅ 原生支持 现代项目、标准API调用
回调函数 PHP 5.2.0+ ✅ 完全自定义 ✅ 需手动处理帧 流式处理、性能监控

〔4〕关键选项深度解析

必须掌握的7个核心选项

  • CURLOPT_RETURNTRANSFER:启用后curl_exec()返回字符串而非直接输出,php curl获取header前必须设置。
  • CURLOPT_HEADER:布尔值,决定是否将响应头包含在返回结果中(默认false)。
  • CURLOPT_HEADEROPT:决定响应头存储模式(CURLHEADER_SEPARATE/CURLHEADER_UNIFIED)。
  • CURLOPT_NOBODY:仅请求头信息,不下载响应体,用于轻量级检查(如HEAD请求)。
  • CURLOPT_HTTPHEADER:设置请求头,但注意:此选项仅影响请求头,不影响响应头获取。
  • CURLOPT_HEADERFUNCTION:自定义响应头回调函数,高级用法。
  • curl_getinfo($ch, CURLINFO_HEADER):获取响应头数组(需配合CURLHEADER_SEPARATE)。

HTTP/2环境下的特殊处理

在HTTP/2连接中,响应头被压缩为HPACK编码帧,cURL会自动解压,但原始二进制数据不可见。此时需注意:① curl_getinfo($ch, CURLINFO_HEADER_SIZE)返回的是解压后头长度;② 使用CURLOPT_HEADEROPT时,cURL内部处理解压,开发者无需干预;③ 若需分析压缩头,需启用curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2_0)并配合curl_getinfo($ch, CURLINFO_HTTP_VERSION)验证协议版本。

<?php
$ch = curl_init('https://http2.golang.org/reqinfo');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2_0);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
$response = curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
$httpVersion = curl_getinfo($ch, CURLINFO_HTTP_VERSION); // 2表示HTTP/2
// 确认协议版本
if ($httpVersion == 2) {
    // HTTP/2专用处理逻辑
}
curl_close($ch);
?>

〔5〕12个实战案例详解

案例1:获取API调用配额(监控频次)

许多API通过响应头返回配额信息,如GitHub的X-RateLimit-Remaining字段。以下代码实现自动检测并预警:

<?php
$ch = curl_init('https://api.github.com/user');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: token YOUR_TOKEN',
    'User-Agent: My-GitHub-App'
]);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
$response = curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
$remaining = (int)($headers['X-RateLimit-Remaining'] ?? 0);
if ($remaining < 10) {
    error_log('⚠️ API配额不足!剩余:' . $remaining);
}
?>

案例2:条件请求(If-Modified-Since)

通过Last-Modified实现资源增量更新,节省带宽:

<?php
// 从本地缓存获取上次修改时间
$lastModified = file_exists('cache.json') ?
    filemtime('cache.json') : 0;
$ch = curl_init('https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'If-Modified-Since: ' . gmdate('D, d M Y H:i:s', $lastModified) . ' GMT'
]);
$response = curl_exec($ch);
$info = curl_getinfo($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
if ($info['http_code'] == 304) {
    echo '资源未更新,使用缓存';
} else {
    // 保存新资源
    file_put_contents('cache.json', $response);
    file_put_contents('cache_meta.json', json_encode([
        'lastModified' => $headers['Last-Modified'] ?? ''
    ]));
}
?>

案例3:自动处理重定向(含Header)

某些服务通过Location头实现动态重定向,需跟踪所有跳转步骤:

<?php
$ch = curl_init('https://short.url/example');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_MAXREDIRS, 5);
$response = curl_exec($ch);
$redirects = curl_getinfo($ch, CURLINFO_REDIRECT_URL);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
// 记录重定向链
if (!empty($redirects)) {
    echo "重定向链:\n";
    foreach ($redirects as $i => $url) {
        echo ($i+1) . ". $url\n";
    }
}
?>

案例4:解析Set-Cookie多值

响应头可能包含多个Set-Cookie,需正确解析为数组:

<?php
$ch = curl_init('https://api.example.com/login');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
// 处理Set-Cookie数组
$cookies = [];
if (isset($headers['Set-Cookie'])) {
    $items = is_array($headers['Set-Cookie'])
        ? $headers['Set-Cookie']
        : [$headers['Set-Cookie']];
    foreach ($items as $cookie) {
        // 解析Cookie字段
        $parts = explode(';', $cookie);
        $nameVal = explode('=', array_shift($parts), 2);
        $cookies[] = [
            'name' => $nameVal[0],
            'value' => $nameVal[1] ?? '',
            'attributes' => $parts
        ];
    }
}
print_r($cookies);
?>

案例5:检测CDN缓存状态

通过X-Cache或X-Cache-Lookup判断是否命中缓存:

<?php
$ch = curl_init('https://cdn.example.com/image.png');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
$cacheStatus = $headers['X-Cache'] ?? $headers['X-Cache-Lookup'] ?? 'unknown';
echo "缓存状态:$cacheStatus\n";
// 输出示例:Hit from cloudfront 或 Miss from cloudfront
?>

案例6:处理Content-Type字符集

自动识别响应编码以避免乱码:

<?php
$ch = curl_init('https://api.example.com/zh-CN');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
$response = curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
$contentType = $headers['Content-Type'] ?? 'text/html';
preg_match('/charset=([\w-]+)/i', $contentType, $matches);
$charset = strtoupper($matches[1] ?? 'UTF-8');
// 自动转码
if ($charset !== 'UTF-8' && function_exists('iconv')) {
    $response = iconv($charset, 'UTF-8//IGNORE', $response);
}
?>

案例7:调试CORS预检请求

通过Access-Control-Allow-Origin验证跨域配置:

<?php
$ch = curl_init('https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Origin: https://myapp.com',
    'Access-Control-Request-Method: POST',
    'Access-Control-Request-Headers: X-Custom-Header'
]);
curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
$allowedOrigins = $headers['Access-Control-Allow-Origin'] ?? '';
$allowedHeaders = $headers['Access-Control-Allow-Headers'] ?? '';
$allowedMethods = $headers['Access-Control-Allow-Methods'] ?? '';
// 验证跨域配置
if ($allowedOrigins !== '*' && strpos($allowedOrigins, 'https://myapp.com') === false) {
    throw new Exception('CORS配置错误:Origin未授权');
}
?>

案例8:获取响应时间戳(Date头)

用于校准本地时间与服务器时间的偏差:

<?php
$ch = curl_init('https://api.example.com/time');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
if (isset($headers['Date'])) {
    $serverTime = strtotime($headers['Date']);
    $localTime = time();
    $offset = $serverTime - $localTime;
    echo "服务器时间:$serverTime\n";
    echo "本地时间:$localTime\n";
    echo "时间差:$offset 秒\n";
}
?>

案例9:解析Content-Encoding解压

处理gzip/br压缩响应头,自动解压响应体:

<?php
$ch = curl_init('https://api.example.com/optimized');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_setopt($ch, CURLOPT_ENCODING, ''); // 自动支持所有压缩格式
$response = curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
$encoding = $headers['Content-Encoding'] ?? 'identity';
if ($encoding !== 'identity') {
    $response = gzdecode($response); // 需开启zlib扩展
}
?>

案例10:HTTP/3(QUIC)Header兼容

QUIC协议使用HPACK+QPACK混合压缩,cURL 7.66.0+支持:

<?php
$ch = curl_init('https://quic.example.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_3);
curl_exec($ch);
$headers = curl_getinfo($ch, CURLINFO_HEADER);
curl_close($ch);
// HTTP/3下所有Header仍可正常获取
// 注意:需系统支持QUIC(如使用nghttp3库)
?>

案例11:批量请求Header聚合

使用curl_multi_*并行请求,汇总所有响应头:

<?php
$urls = [
    'https://api.example.com/v1',
    'https://api.example.com/v2',
    'https://api.example.com/v3'
];
$mh = curl_multi_init();
$handles = [];
foreach ($urls as $url) {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
    curl_multi_add_handle($mh, $ch);
    $handles[] = $ch;
}
// 执行并收集结果
do {
    curl_multi_exec($mh, $running);
} while ($running);
$headersList = [];
foreach ($handles as $ch) {
    $headers = curl_multi_getcontent($ch);
    $headersList[] = curl_getinfo($ch, CURLINFO_HEADER);
    curl_multi_remove_handle($mh, $ch);
}
curl_multi_close($mh);
// 示例:检查所有响应的Content-Type
foreach ($headersList as $i => $headers) {
    echo "请求$i+1的Content-Type:" . ($headers['Content-Type'] ?? 'unknown') . "\n";
}
?>

案例12:Header性能分析(响应头时间戳)

记录Header接收时间,用于网络延迟分析:

<?php
class TimingHeaderParser {
    public $startTime;
    public $headerLines = [];
    public function __construct() {
        $this->startTime = microtime(true);
    }
    public function parseHeader($ch, $line) {
        $line = trim($line);
        if ($line === '') {
            $this->headerEnd = microtime(true);
            return strlen($line);
        }
        $this->headerLines[] = [
            'line' => $line,
            'timestamp' => microtime(true) - $this->startTime
        ];
        return strlen($line);
    }
}
$parser = new TimingHeaderParser();
$ch = curl_init('https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADERFUNCTION, [$parser, 'parseHeader']);
curl_exec($ch);
curl_close($ch);
// 分析Header接收耗时
$totalHeaderTime = ($parser->headerEnd - $parser->startTime) * 1000;
echo "Header接收耗时:$totalHeaderTime ms\n";
print_r(array_slice($parser->headerLines, 0, 3)); // 显示前3行
?>

〔6〕网友最关心的8个高频问题

Q1:为什么设置了CURLOPT_HEADER但响应头仍为空?

A:可能原因包括:① 服务器未返回任何Header(如纯二进制响应);② 请求失败(如404/500)导致Header被跳过;③ cURL错误(需检查curl_error($ch))。建议先用curl_getinfo($ch, CURLINFO_HTTP_CODE)确认状态码,再通过curl_getinfo($ch, CURLINFO_HEADER_SIZE)验证Header长度。

Q2:如何获取原始未解析的Header字符串?

A:使用curl_getinfo($ch, CURLINFO_HEADER)在CURLHEADER_SEPARATE模式下返回的是数组。若需原始字符串,可改用手动分割方案:启用CURLOPT_HEADER后,通过curl_getinfo($ch, CURLINFO_HEADER_SIZE)获取偏移量,再用substr($response, 0, $headerSize)截取。

Q3:重复Header(如多个Set-Cookie)为何丢失?

A:这是默认行为!cURL将重复Header的值合并为字符串(用逗号分隔),但HTTP规范允许重复Header独立存在。解决方案:① 使用CURLOPT_HEADEROPT + CURLHEADER_SEPARATE;② 自定义回调函数;③ 升级cURL库至7.61.0+(支持CURLINFO_HEADER返回数组)。

Q4:PHP 5.4能否使用CURLHEADER_SEPARATE?

A:不能!CURLOPT_HEADEROPT是PHP 5.6.0新增选项。低版本需使用手动分割方案,但需注意:① 避免用explode("\r\n", $response)分割(可能误切响应体);② 优先用strpos($response, "\r\n\r\n")定位分隔点;③ 用curl_getinfo($ch, CURLINFO_HEADER_SIZE)校验偏移量增强可靠性。

Q5:HTTP/2下如何获取HPACK解压后的Header?

A:cURL已自动处理HPACK解压,开发者无需干预。只需确保:① cURL库版本≥7.36.0;② 启用CURLOPT_HEADEROPT;③ 使用curl_getinfo($ch, CURLINFO_HEADER)获取数组。若需分析压缩帧,需启用curl_setopt($ch, CURLOPT_DEBUGFUNCTION, ...),但仅限开发调试。

Q6:如何区分状态行(如HTTP/1.1 200 OK)和普通Header?

A:状态行是Header的第一行,以HTTP/开头。在解析时需跳过:① 手动分割方案中,用explode("\r\n", $headersRaw)后检查第一行是否以HTTP/开头;② 回调函数方案中,过滤掉首行状态行再解析键值对。

Q7:响应头包含中文会乱码吗?

A:不会!HTTP/1.1规范要求Header值使用ASCII编码,非ASCII字符需用RFC 2047编码(如=?UTF-8?B?...?==)。现代服务器通常将中文转为UTF-8 Base64编码。若需解码,可使用imap_utf8($value)或正则处理=?charset?encoding?encoded-text?= 格式。

Q8:如何防止Header注入攻击?

A:当Header值来自用户输入时(如自定义User-Agent),必须过滤换行符(\r\n),避免注入额外Header。解决方案:① 用str_replace(["\r", "\n"], '', $value)清理输入;② 严格校验Header键名(仅允许字母数字和连字符);③ 使用filter_var($value, FILTER_SANITIZE_STRING)过滤特殊字符。

〔7〕php curl获取header技术演进时间轴

2002年:cURL 7.9.2 - 初代支持

cURL首次集成PHP扩展,仅支持基础Header获取,需手动分割响应体与头。

2008年:PHP 5.2.0 - CURLOPT_RETURNTRANSFER

新增CURLOPT_RETURNTRANSFER选项,使curl_exec()返回字符串而非直接输出,奠定Header分离基础。

2013年:cURL 7.33.0 - HTTP/2支持

原生支持HTTP/2协议,但响应头以二进制帧传输,需依赖curl_getinfo()间接获取。

2015年:PHP 5.6.0 - CURLOPT_HEADEROPT

革命性更新!新增CURLOPT_HEADEROPT选项,支持CURLHEADER_SEPARATE模式,自动解析Header为数组。

2018年:cURL 7.61.0 - 重复Header数组化

curl_getinfo($ch, CURLINFO_HEADER)在CURLHEADER_SEPARATE模式下返回重复Header数组,解决Set-Cookie丢失问题。

2020年:HTTP/3(QUIC)支持

cURL 7.66.0+支持QUIC协议,Header采用QPACK压缩,但API层仍保持兼容。

2023年:现代最佳实践

推荐方案:CURLOPT_HEADEROPT + CURLHEADER_SEPARATE + curl_getinfo($ch, CURLINFO_HEADER),兼顾功能、兼容性与可维护性。