PHP分块下载：如何从流请求获取Content-Length与响应信息

为什么get_headers()拿不到Content-Length？ #

当服务器采用**分块传输编码（Transfer-Encoding: chunked）**返回响应时，HTTP协议规范明确不会返回Content-Length头——因为内容是分批次发送的，服务器可能无法提前知晓总大小，或者刻意不提供该信息。这种情况非常普遍，很多开发者处理流式下载时都会遇到。

如何从响应流中获取Content-Type？ #

可以通过stream_get_meta_data()读取流的元数据，从中解析出响应头里的Content-Type，示例代码如下：

$options = array(
    'http' => array(
        'header' => "Authorization: Bearer $accessToken\r\n"
    )
);
$context = stream_context_create($options);
$sourceFileStream = fopen($sourceFile, 'rb', false, $context);

// 获取流的元数据
$streamMeta = stream_get_meta_data($sourceFileStream);
$responseHeaders = $streamMeta['wrapper_data'];

// 解析Content-Type
$contentType = null;
foreach ($responseHeaders as $header) {
    if (str_starts_with($header, 'Content-Type:')) {
        $contentType = trim(substr($header, strlen('Content-Type:')));
        break;
    }
}

// 输出结果
echo "Content-Type: " . $contentType;

如何获取分块响应的总大小？ #

分块传输的响应没有Content-Length，无法提前获取总大小。如果需求是只下载大于1GB的文件，有两种处理思路：

思路1：尝试让服务器返回非分块响应 #

在请求头中添加Transfer-Encoding: identity，强制服务器使用固定长度传输（需服务器支持）：

$options = array(
    'http' => array(
        'header' => "Authorization: Bearer $accessToken\r\n" .
                    "Transfer-Encoding: identity\r\n"
    )
);
$context = stream_context_create($options);

// 先获取头信息判断大小
$fileHeaders = get_headers($sourceFile, 1, $context);
if (isset($fileHeaders['Content-Length'])) {
    $fileSize = (int)$fileHeaders['Content-Length'];
    if ($fileSize > 1024 * 1024 * 1024) {
        // 文件大于1GB，开始下载
        $sourceFileStream = fopen($sourceFile, 'rb', false, $context);
        // 后续写入本地文件逻辑...
    }
}

注意：不是所有服务器都支持该请求头，需测试验证。

思路2：边下载边统计字节数 #

如果服务器坚持用分块传输，只能先下载内容，同时累计字节数，达到1GB阈值后再决定是否继续保存：

$options = array(
    'http' => array(
        'header' => "Authorization: Bearer $accessToken\r\n"
    )
);
$context = stream_context_create($options);
$sourceFileStream = fopen($sourceFile, 'rb', false, $context);

$totalBytes = 0;
$chunkSize = 8192; // 每次读取8KB
$targetFile = fopen('/path/to/local/file', 'wb');

while (!feof($sourceFileStream)) {
    $chunk = fread($sourceFileStream, $chunkSize);
    $totalBytes += strlen($chunk);
    
    if ($totalBytes > 1024 * 1024 * 1024) {
        // 已超过1GB，继续写入剩余内容
        fwrite($targetFile, $chunk);
    } else {
        // 未达到1GB，中断下载
        fclose($sourceFileStream);
        fclose($targetFile);
        // 删除未完成的文件
        unlink('/path/to/local/file');
        break;
    }
}

// 完成下载后的清理
fclose($sourceFileStream);
fclose($targetFile);

这种方式会消耗一定带宽，但在服务器不提供Content-Length的情况下是唯一可行的方案。

内容的提问来源于stack exchange，提问作者Harry