phpenv安装PHP时必须显式指定--with-zlib=/usr等参数启用zlib，否则zlib.output_compression和ob_gzhandler将失效；安装后需手动配置对应版本的php.ini并确认extension_loaded('zlib')为true。
phpenv 管理的 PHP 版本默认已内置 zlib，无需额外“开启扩展”，但必须确保编译时启用了 --with-zlib，否则 zlib.output_compression 和 ob_gzhandler 会直接失效。
phpenv install 时必须显式带上 --with-zlib
phpenv 本身不自动启用 zlib 支持；它依赖底层 php-build 编译过程。如果你用 phpenv install 8.2.10 这种默认命令，zlib 很可能被跳过——尤其在 Alpine 或最小化系统上。
- 正确做法是：安装时强制指定 zlib 路径（Linux 常见路径为
/usr或/usr/lib）：phpenv install 8.2.10 --with-zlib=/usr
- 若系统 zlib 头文件不在标准路径（如 CentOS 的
/usr/include/zlib.h），需同时加--with-zlib-dir：phpenv install 8.3.5 --with-zlib=/usr --with-zlib-dir=/usr
- 验证是否成功：装完后运行
phpenv shell 8.3.5 && php -m | grep zlib，有输出即表示扩展加载成功；若为空，说明编译阶段就漏掉了。
php.ini 中 zlib.output_compression 生效的前提
即使 php -m 显示 zlib 已加载，zlib.output_compression = On 仍可能不生效——因为 phpenv 默认不生成或修改 php.ini，你拿到的是 PHP 源码自带的 minimal 配置。
- 先定位当前版本的配置路径：
phpenv shell 8.3.5 && php --ini
关注 “Loaded Configuration File” 行。 - 若该路径为空（即无
php.ini），需从php.ini-development或php.ini-production复制一份：cp $(php --ini | grep "Scan for additional" | awk -F': ' '{print $2}')/php.ini-development ~/.phpenv/versions/8.3.5/etc/php.ini - 编辑该
php.ini，确认以下两项未被注释且值合理：zlib.output_compression = On<br>zlib.output_compression_level = 6
- 重启 PHP-FPM 或 Apache/Nginx（取决于你的 SAPI）；CLI 模式下无需重启，但需确保
phpenv shell已切换到目标版本。
为什么 ob_gzhandler 在 phpenv 环境里常报错
常见错误是 Warning: ob_start(): output handler 'ob_gzhandler' cannot be used after zlib.output_compression，或更隐蔽的 Content-Encoding: gzip 出现但体积没变小——这基本等于 zlib 没真正起作用。
立即学习“PHP免费学习笔记（深入）”；
- 根本原因：phpenv 安装的 PHP 若未带 zlib，
extension_loaded('zlib')返回false，ob_gzhandler降级为无效回调，缓冲区照常输出但不压缩。 - 另一个坑：某些 phpenv 插件（如
phpenv-composer）会在~/.phpenv/version写死版本，导致phpenv shell切换后php --ini仍读旧配置，务必用phpenv version和php -r "echo ini_get('zlib.output_compression');"双重确认。 - 调试建议：在脚本开头加一行：
var_dump(['zlib_ext' => extension_loaded('zlib'), 'zlib_on' => ini_get('zlib.output_compression')]);不要只信 phpinfo() 页面——它可能缓存或显示全局配置而非当前 SAPI 实际加载的。
最易被忽略的一点：phpenv 管理的多版本之间 php.ini 是隔离的，改了 8.1 的配置不会影响 8.3；而 zlib.output_compression 必须对每个启用压缩的版本单独配置，不能“一劳永逸”。
