PHP编译未加--with-zlib则zlib扩展默认不启用，extension_loaded('zlib')返回false，gzopen等函数报错；补救需重装并显式添加该参数。
phpenv install 时没带 --with-zlib，扩展就默认不启用
phpenv 编译安装 PHP 时，zlib 不是默认内置项——哪怕系统已装 zlib1g-dev，只要编译参数里没显式加上 --with-zlib，生成的 PHP 二进制就不会包含 zlib 支持。这意味着 extension_loaded('zlib') 会返回 false，所有 gzopen、gzencode 都会报 Call to undefined function 错误。
验证方式很简单：
phpenv global 8.1.12<br>php -m | grep zlib
如果无输出，说明缺失。补救只能重装：
phpenv uninstall 8.1.12-
phpenv install 8.1.12 --with-zlib（Linux/macOS） - macOS 若用 Homebrew 安装 zlib，可能需加路径：
phpenv install 8.1.12 --with-zlib=/opt/homebrew/opt/zlib
php.ini 里 zlib.output_compression 不等于“网页自动压缩”
很多人以为把 zlib.output_compression = On 一开，PHP 输出就自动 GZIP 了。其实它只对 echo、print 等直接输出生效，对 ob_start() 后再 ob_end_flush() 的内容无效——除非你手动注册回调函数，比如 ob_start('ob_gzhandler') 或自定义 ob_gzip。
立即学习“PHP免费学习笔记（深入）”；
更关键的是：这个配置只影响 PHP-FPM 的响应体，**不接管 Nginx/Apache 的 gzip 功能**。如果你用的是 Nginx + php-fpm 架构，Nginx 层的 gzip on 优先级更高，且能压缩静态文件、合并响应头，比 PHP 层压缩更可靠。
所以真实建议是：
- 开发调试阶段可开
zlib.output_compression = On快速验证 - 生产环境关掉它，改由 Web 服务器统一处理（Nginx 配置
gzip on+gzip_types text/html application/json） - 若必须在 PHP 层控制（如 API 响应需差异化压缩），用
gzencode($data, 6)手动编码 +header('Content-Encoding: gzip')，并确保headers_sent() === false
gzip 压缩级别选 6 而不是 9，是权衡结果
gzencode($data, 9) 确实压缩率最高，但 CPU 开销陡增，尤其在高并发下容易成为瓶颈；而 gzencode($data, 1) 几乎不压缩，体积节省有限。实际测试表明，级别 6 是吞吐与压缩比最均衡的点——比默认 6 再提一级到 7，体积只少 1%～2%，CPU 时间却多 30%+。
注意两个边界情况：
- 小于 20 字节的字符串经
gzencode反而变大（因 GZIP 头部固定开销约 18 字节） -
gzcompress和gzdeflate输出的是原始 DEFLATE 数据，不含 GZIP 头，不能直接配Content-Encoding: gzip，浏览器会解压失败 - 若要兼容 Python/Node.js 解压，优先用
gzencode（标准 GZIP 格式），别用gzcompress
readgzfile 和 gzfile 返回值类型差异容易踩坑
readgzfile('./data.gz') 直接输出到 stdout 并返回字节数；gzfile('./data.gz') 返回数组，每行一个元素（含换行符）。很多人想读取压缩内容做后续处理，却误用 readgzfile，结果内容直接刷到 HTTP 响应流里，后面再 echo 就乱序了。
安全做法是：
- 要获取字符串内容 → 用
file_get_contents('compress.zlib://./data.gz')（最简洁） - 要逐行处理 →
$lines = gzfile('./data.gz')，然后foreach ($lines as $line) - 要流式读取大文件 →
$fp = gzopen('./data.gz', 'r')配合gzread($fp, 8192) - 别用
readgzfile做逻辑判断依据，它只适合“一次性吐出”场景
zlib 的坑不在函数难写，而在行为隐式、边界模糊——比如 gzopen 的模式字符串 w9 里那个 9，其实是压缩级别，但写成 w6 就完全无效，必须紧贴 w 后面，中间不能有空格。
