如何在内存受限环境下高效解压超大 GZ 文件

本文介绍使用 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 + 缓冲开销）。

✅ 正确实践示例（安全、低内存、可中断）：

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) . " bytesr";     }      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 文件唯一健壮、标准且内存友好的方案。