php 8.6新增curlinfo_size_delivered及curl_getinfo()中的size_delivered字段,用来统计交给下载写入回调的正文体积,要求libcurl 8.20.0或更新版本。开启自动解压后,它与压缩传输量可能不同;需要限制实际写入体积时,应在回调中累计并拒绝超限数据,不能等请求结束后只读一个统计值。

size_delivered统计传给写入回调的字节,不等同于压缩下载量。
准备只监听本机的gzip响应
保存为fixture.php,使用有zlib扩展的PHP运行。该文件只用于受控测试,不读取用户传入的文件路径或远程地址。
<?php
$body = json_encode(['message' => str_repeat('测试内容', 2000)], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
$compressed = gzencode($body);
if ($compressed === false) {
http_response_code(500);
exit;
}
header('Content-Type: application/json; charset=utf-8');
header('Content-Encoding: gzip');
header('Content-Length: ' . strlen($compressed));
echo $compressed;
php -S 127.0.0.1:8081 fixture.php
边写入边检查解压后的上限
另存client.php,在第二个终端用PHP 8.6执行。示例采用固定本机地址,最多存入1MiB解压正文,不跟随跳转。
<?php
if (PHP_VERSION_ID < 80600 || !extension_loaded('curl')
|| !defined('CURLINFO_SIZE_DELIVERED')
|| curl_version()['version_number'] < 0x081400) {
throw new RuntimeException('需要PHP 8.6、curl扩展和libcurl 8.20.0+');
}
$sink = fopen('php://temp', 'w+b');
if ($sink === false) { throw new RuntimeException('不能创建输出流'); }
$ch = curl_init('http://127.0.0.1:8081/report');
if ($ch === false) { fclose($sink); throw new RuntimeException('不能初始化cURL'); }
$stored = 0;
$limit = 1024 * 1024;
$overLimit = false;
try {
curl_setopt_array($ch, [
CURLOPT_ACCEPT_ENCODING => 'gzip',
CURLOPT_HEADER => false,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_CONNECTTIMEOUT => 3,
CURLOPT_TIMEOUT => 10,
CURLOPT_WRITEFUNCTION => static function ($handle, string $chunk) use ($sink, &$stored, $limit, &$overLimit): int {
$length = strlen($chunk);
if ($stored + $length > $limit) {
$overLimit = true;
return 0;
}
$written = fwrite($sink, $chunk);
if ($written !== $length) { return 0; }
$stored += $written;
return $written;
},
]);
if (curl_exec($ch) === false) {
throw new RuntimeException($overLimit ? '解压后正文超出上限' : '下载未完整完成:' . curl_error($ch));
}
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) !== 200) {
throw new RuntimeException('测试服务未返回HTTP 200');
}
$delivered = curl_getinfo($ch, CURLINFO_SIZE_DELIVERED);
$downloaded = curl_getinfo($ch, CURLINFO_SIZE_DOWNLOAD_T);
if (!is_int($delivered) || $delivered !== $stored) {
throw new RuntimeException('交付统计与成功存储量不一致');
}
printf("正文交付%d字节,下载统计%d字节\n", $delivered, $downloaded);
} finally {
unset($ch);
fclose($sink);
}

官方测试同时检查传输前为0,以及完成后的整数类型和正值。
按成功和失败分开解释结果
压缩传输成功时,下载量反映压缩正文,交付量反映回调收到的解压内容;统计针对最近一次传输,响应头是否并入回调也会改变口径。代码显式关闭CURLOPT_HEADER,只有完整成功后才比较交付量与存储量,失败时不能把部分数据当作完整报告。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
回调返回0会使传输失败;写入失败和超限都应丢弃当前结果。这个上限约束的是实际存入输出流的正文,不保证限制解压库的全部内存、CPU消耗或网络开销。移到真实下载服务时,还需独立的可信地址策略、超时和并发控制,不能把示例改成接受任意URL的代理。
立即学习“PHP免费学习笔记(深入)”;


















