本文介绍使用 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 级压缩文件。
以下是一个健壮、可落地的分块解压示例：
getMessage()); } ?>
✅ 关键优势说明：
- 内存恒定：无论源文件多大，峰值内存占用仅与 $chunkSize（如 64KB）及 zlib 内部缓冲相关，通常
- 无需修改 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 流式哲学的解决方案。它不依赖第三方库、不增加部署复杂度，且代码简洁易维护，是内存敏感型应用的标准实践。
