PHP 8.0 的 zlib 扩展必须编译时通过 --with-zlib 显式启用，否则所有压缩功能失效；phpenv install 需手动指定 zlib 路径，装完须验证扩展加载及 php.ini 配置，Web 与 CLI 的配置分离，生产环境推荐 Nginx 压缩替代 zlib.output_compression。
PHP 8.0 的 zlib 扩展不是“开关式启用”，而是编译时决定的——没带 --with-zlib 编译，extension_loaded('zlib') 就永远是 false，后续所有压缩功能（gzencode、ob_gzhandler、zlib.output_compression）都会直接失效或报错。
phpenv install 时必须显式加 --with-zlib
phpenv 本身不自动注入 zlib 支持，它完全依赖底层 php-build 的编译参数。用 phpenv install 8.0.30 这种默认命令，在 Alpine、CentOS Stream 或最小化系统上极易漏掉 zlib。
- Linux（Debian/Ubuntu/CentOS）常见写法：
phpenv install 8.0.30 --with-zlib=/usr - macOS + Homebrew：先确认 zlib 路径：
brew --prefix zlib，再传参，例如：phpenv install 8.0.30 --with-zlib=/opt/homebrew/opt/zlib - 若头文件不在标准位置（如 CentOS 的
/usr/include/zlib.h被移走），需额外加--with-zlib-dir：phpenv install 8.0.30 --with-zlib=/usr --with-zlib-dir=/usr - 装完立刻验证：
phpenv shell 8.0.30 && php -m | grep zlib—— 无输出=编译失败，只能重装
CLI 和 Web SAPI 的 php.ini 是两套配置
即使 php -m 显示 zlib 已加载，zlib.output_compression = On 仍可能不生效，因为 phpenv 默认不生成完整 php.ini，你拿到的是 PHP 源码自带的 minimal 配置（几乎全注释）。
- 先定位 CLI 当前生效的配置：
php --ini，看 “Loaded Configuration File” 行 - 若为空，说明没 php.ini：从
php.ini-development复制一份：cp $(php --ini | grep "Scan for additional" | awk -F': ' '{print $2}')/php.ini-development ~/.phpenv/versions/8.0.30/etc/php.ini - 编辑该文件，确保以下两行未被注释且值合理：
zlib.output_compression = On<br>zlib.output_compression_level = 6
- 注意：Web 环境（如 Nginx+php-fpm）用的是另一份 php.ini，路径通常为
~/.phpenv/versions/8.0.30/etc/php-fpm.d/www.conf关联的配置，需单独检查
ob_gzhandler 报错或压缩无效的真正原因
典型错误：Warning: ob_start(): output handler 'ob_gzhandler' cannot be used after zlib.output_compression，或响应头有 Content-Encoding: gzip 但体积没变小——这说明 zlib 根本没起作用，只是 header 被硬塞了。
立即学习“PHP免费学习笔记（深入）”；
- 根本原因只有两个：①
extension_loaded('zlib')返回false（编译漏了）；②zlib.output_compression = On开着，又手动调ob_start('ob_gzhandler')，PHP 会拒绝重复压缩 - 生产环境强烈建议关掉
zlib.output_compression，改由 Nginx 统一处理：gzip on;+gzip_types text/html application/json—— 它能压缩静态资源、合并 header、更稳定 - 若必须在 PHP 层控制（如 API 响应按条件压缩），用
gzencode($data, 6)+header('Content-Encoding: gzip')，但务必提前检查headers_sent() === false - 别用
gzcompress()或gzdeflate()配Content-Encoding: gzip，它们输出的是 raw DEFLATE 数据，缺 GZIP 头，浏览器解不了
最易被忽略的一点：小于 20 字节的字符串经 gzencode 后反而变大（GZIP 头部固定约 18 字节），压缩逻辑里必须加长度判断；另外，zlib.output_compression_level = 9 在高并发下 CPU 开销陡增，实测级别 6 是吞吐与压缩比的真实平衡点。
