本文介绍使用 php 原生流式解压函数 `gzopen()` + `gzread()` 分块读取并解压超大 `.gz` 文件的方法，避免 `gzdecode()` 因一次性加载全量数据导致的内存溢出问题。
当处理超过 200 MB 的 .gz 压缩文件（原始数据达数 GB）时，直接调用 gzdecode(@file_get_contents($file)) 会强制将整个压缩流载入内存，极易触发 Allowed memory size exhausted 错误——即使将 memory_limit 调高至 1GB 以上，也违背了低资源环境（如共享主机、容器化部署或无权修改 php.ini 的生产环境）的设计约束。
根本解决思路是放弃“全量加载→全量解码”模式，转向流式逐块解压。PHP 提供了专为 gzip 流设计的底层函数族：gzopen()、gzread()、gzwrite() 和 gzclose()，它们基于 zlib 的流式接口，仅在内存中维持极小的解压缓冲区（默认几 KB），可稳定处理 TB 级压缩文件。
以下是一个健壮、可落地的分块解压示例：
<?php
function streamGunzip($gzFilePath, $outputPath, $chunkSize = 8192) {
// 以二进制读模式打开 .gz 文件
$gz = gzopen($gzFilePath, 'rb');
if ($gz === false) {
throw new RuntimeException("Failed to open gzip 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)) {
if (fwrite($fp, $chunk) === false) {
break; // 写入失败则中断
}
}
// 关闭流
gzclose($gz);
fclose($fp);
// 可选：校验解压完整性（检查是否 EOF 正常结束）
if (gzeof($gz)) {
echo "Decompression completed successfully.\n";
} else {
echo "Warning: Incomplete decompression detected.\n";
}
}
// 使用示例
try {
streamGunzip('/path/to/large-file.gz', '/path/to/unpacked.bin', 65536); // 64KB 每次读取
} catch (Exception $e) {
error_log('Decompression failed: ' . $e->getMessage());
}
?>✅ 关键优势说明：
- 内存恒定：无论源文件多大，峰值内存占用仅与 $chunkSize（如 64KB）及 zlib 内部缓冲相关，通常 < 1MB；
- 无需修改 memory_limit：完全绕过 file_get_contents 和 gzdecode 的内存瓶颈；
- 天然支持超大文件：gzopen() 底层调用 zlib 的 gzdopen()，支持任意长度流；
- 错误可控：可结合 gzeof() 判断是否正常结束，配合 gzerrno() 获取 zlib 错误码（如 Z_DATA_ERROR 表示损坏）。
⚠️ 注意事项：
- 确保 PHP 编译时启用了 zlib 扩展（绝大多数发行版默认开启，可通过 extension_loaded('zlib') 验证）；
- gzread() 返回 false 表示读取错误（非 EOF），应检查 gzerrno($gz)；
- 若需解压后进一步处理（如解析 JSON/CSV），建议将 gzread() 结果直接送入处理器，避免中间落盘；
- 对于需要保留原始文件名或元信息的场景，gzopen() 不提供 header 解析能力，此时需借助 zlib C 扩展或外部命令（如 gunzip -c + proc_open），但会牺牲纯 PHP 可移植性。
综上，gzopen() + gzread() 是 PHP 生态中处理超大 GZ 文件最轻量、最可靠、最符合 Unix 流式哲学的解决方案。它不依赖第三方库、不增加部署复杂度，且代码简洁易维护，是内存敏感型应用的标准实践。
