本文介绍使用 php 的 `gzopen()` 和 `gzread()` 流式读取方式，分块解压超大 `.gz` 文件（如 200mb 压缩包、解压后达 4gb），彻底规避 `gzdecode()` 内存溢出问题。
当处理大型 GZ 压缩文件（例如压缩后 200MB、解压后超过 4GB）时，直接调用 gzdecode(@file_get_contents($file)) 会将整个压缩内容一次性载入内存，极易触发 Allowed memory size exhausted 错误——即使将 memory_limit 调至 512MB 甚至更高，也难以应对远超内存容量的原始数据。
根本解决思路是避免全量加载，转而采用流式（streaming）解压：PHP 提供了原生的 zlib 流支持，gzopen() 可以像打开普通文件一样打开 .gz 文件，并通过 gzread() 按需读取指定字节数的解压后明文内容，全程仅占用恒定小内存（如每次读取 8192 字节，内存占用始终 ≈ 8KB + 缓冲开销）。
✅ 正确实践示例（安全、低内存、可中断）：
<?php
function streamGunzip($gzPath, $outputPath, $chunkSize = 8192) {
if (!file_exists($gzPath)) {
throw new RuntimeException("GZ file not found: $gzPath");
}
$gz = gzopen($gzPath, 'rb');
if ($gz === false) {
throw new RuntimeException("Failed to open GZ file: $gzPath");
}
$fp = fopen($outputPath, 'wb');
if ($fp === false) {
gzclose($gz);
throw new RuntimeException("Failed to open output file: $outputPath");
}
$totalDecompressed = 0;
while (($chunk = gzread($gz, $chunkSize)) !== false && $chunk !== '') {
if (fwrite($fp, $chunk) === false) {
break;
}
$totalDecompressed += strlen($chunk);
// 可选：记录进度（适用于 CLI 或长任务）
// echo "Decompressed: " . number_format($totalDecompressed) . " bytes\r";
}
gzclose($gz);
fclose($fp);
if (gzeof($gz)) {
echo "✅ Successfully decompressed to $outputPath (" . number_format($totalDecompressed) . " bytes)\n";
} else {
throw new RuntimeException("Error during decompression (truncated or corrupted GZ stream)");
}
}
// 使用示例：
streamGunzip('/path/to/large-file.tar.gz', '/path/to/large-file.tar');⚠️ 关键注意事项：
- gzopen() 的 'rb' 模式表示以二进制只读方式打开压缩流，返回的是解压后的数据流，无需手动解码；
- gzread($gz, $n) 读取的是解压后的内容长度为最多 $n 字节的明文块，不是压缩数据块——这是与 fread() 的本质区别，也是流式解压的核心优势；
- 不要混用 gzread() 和 fread()；也不要对 gzopen() 返回的句柄调用 fclose()，必须使用 gzclose()；
- 若需实时校验或边解压边处理（如解析 CSV/TAR/JSON），可在 while 循环内对 $chunk 直接操作，实现“解压-处理”流水线，内存零累积；
- 该方案完全绕过 memory_limit 限制，实测可稳定处理原始数据达数十 GB 的 GZ 文件（只要磁盘空间充足）。
? 进阶提示：若需解压 .tar.gz 并提取单个文件（而非全部写入磁盘），可结合 phar:// 或 tar 扩展流式解析；若需支持 HTTP 分块下载解压，可将 gzopen() 替换为 gzopen('php://input', 'rb') 配合 cURL 流式响应。
总之，告别 gzdecode()，拥抱 gzopen() + gzread() —— 这是 PHP 处理超大 GZ 文件唯一健壮、标准且内存友好的方案。
