本文介绍使用 php 原生流式解压函数 `gzopen()` + `gzread()` 分块读取并解压超大 `.gz` 文件的方法，彻底规避 `gzdecode()` 内存溢出问题，适用于无法调高 `memory_limit` 的生产环境。
当处理数百 MB 甚至数 GB 的 .gz 压缩文件（如日志归档、数据备份）时，直接调用 gzdecode(@file_get_contents($file)) 会将整个压缩流一次性加载进内存——即使原始文件仅 200MB，解压后可能膨胀至 4GB+，远超 PHP 默认的 256MB 内存限制，导致致命错误：
PHP Fatal error: Allowed memory size of 268435456 bytes exhausted (tried to allocate ...)
此时强行提升 memory_limit 并非良策：不仅存在安全与稳定性风险，更在共享主机或容器化环境中常被禁止。根本解法是放弃全量加载，改用流式逐块解压。
PHP 提供了原生、轻量、内存友好的 GZIP 流处理接口：gzopen()、gzread() 和 gzclose()。它们底层调用 zlib，以增量方式解压数据，内存占用恒定（仅取决于单次读取缓冲区大小），与文件总大小无关。
✅ 正确做法示例（安全解压大文件）：
<?php
function streamGunzip($gzFilePath, $outputPath, $chunkSize = 8192) {
if (!file_exists($gzFilePath)) {
throw new RuntimeException("GZ file not found: $gzFilePath");
}
$gz = gzopen($gzFilePath, 'rb');
if ($gz === false) {
throw new RuntimeException("Failed to open GZ file: $gzFilePath");
}
$fp = fopen($outputPath, 'wb');
if ($fp === false) {
gzclose($gz);
throw new RuntimeException("Failed to open output file: $outputPath");
}
// 流式读取并写入，每块最多 $chunkSize 字节
while (($chunk = gzread($gz, $chunkSize)) !== false && $chunk !== '') {
if (fwrite($fp, $chunk) === false) {
break;
}
}
gzclose($gz);
fclose($fp);
if (gzeof($gz)) {
echo "Decompression completed successfully.\n";
return true;
} else {
throw new RuntimeException("Error during decompression.");
}
}
// 使用示例（解压 3GB .gz 到 uncompressed.txt）
streamGunzip('/path/to/large-file.gz', '/path/to/uncompressed.txt', 65536); // 推荐 64KB 缓冲
?>? 关键要点与最佳实践：
- 缓冲区大小建议：$chunkSize 设为 8192–65536（8KB–64KB）之间平衡性能与内存；过大无益（仍受限于 PHP 单次 gzread 内部开销），过小则 I/O 频繁降低效率；
- 无需提前知晓原始大小：gzread() 自动处理 gzip 头、校验和及尾部，完全兼容标准 RFC 1952 格式；
- 错误处理不可省略：务必检查 gzopen()/fopen() 返回值，并在异常时及时 gzclose() 防止资源泄漏；
-
替代方案对比：
- ❌ inflate_add() 属于低层 zlib API，需手动管理 inflate 上下文与状态，极易出错且同样可能触发内存告警；
- ❌ shell_exec('gunzip -c ...') 存在安全风险（命令注入）、依赖外部命令、难以捕获进度与错误；
- ✅ gzopen() 是 PHP 官方推荐、稳定、零依赖的标准解决方案。
? 扩展提示：若需实时监控解压进度，可结合 gzseek()（仅支持前向 seek）或通过 ftell() + 文件总大小估算；若目标为解压后直接处理（如解析 CSV/JSON），可将 gzread() 结果直接送入 fgetcsv() 或 json_decode() 流式处理器，实现“边解压边处理”，内存占用始终可控。
总之，面对海量 GZ 数据，放弃“加载—解码—释放”思维，拥抱“打开—分块读取—即时消费”的流式范式，是 PHP 工程师在资源约束下保障健壮性的关键能力。
