zlib扩展未就绪导致gzcompress()等函数不可用，需四步排查：确认编译含--with-zlib、检查phpenv专属php.ini中zlib配置、验证CLI与Web环境一致性、添加运行时兜底判断。
启动 phpenv 管理的 PHP 5.6.40 时提示 zlib 相关错误（如 Call to undefined function gzcompress() 或 zlib extension is not available），本质不是 PHP 启动失败，而是 zlib 扩展未就绪——它可能根本没编译进 PHP、配置被忽略、或运行时被禁用。下面分四步直击关键点，不绕弯。
确认 zlib 是否真被编译进 PHP 二进制
phpenv 切换版本后，实际运行的是它封装的可执行文件，但底层仍是编译产物。先验证 zlib 是否在构建阶段就被排除：
- 执行
php -i | grep -i "zlib support"—— 若输出为空或显示zlib support => disabled，说明编译时漏了--with-zlib - 再查
php -v输出末尾：若含without zlib字样，确认是编译缺失，不是配置问题 - Debian/Ubuntu 用户补装
zlib1g-dev，CentOS/RHEL 用户装zlib-devel，然后用 phpenv 重新编译：phpenv install --reinstall 5.6.40
检查 phpenv 对应 php.ini 是否启用 zlib
phpenv 每个版本有独立的配置目录（通常为 ~/.phpenv/versions/5.6.40/etc/php.ini），别误改系统全局 ini：
- 打开该 php.ini，搜索
zlib，确认没有注释掉extension=zlib（PHP 7.4+ 写法）；PHP 5.6 兼容写法是extension=php_zlib.dll（仅 Windows）或留空（因 zlib 是内置模块） - 特别注意：Windows 下若写了
extension=php_zlib.dll反而会启动失败——PHP 5.6 已内置 zlib，删掉这行即可 - 改完保存，必须重启 PHP 进程（如 php-fpm）或重载 web server，否则不生效
验证 CLI 和 Web 环境是否一致
phpenv 主要影响 CLI，但很多服务（如 php-fpm）可能用的是系统默认 PHP 或另一套配置：
立即学习“PHP免费学习笔记（深入）”；
- CLI 环境检查：
phpenv local 5.6.40 && php -m | grep zlib—— 应输出zlib - Web 环境检查：新建
info.php，内容为<?php phpinfo(); ?>，浏览器访问后搜索 “zlib”，必须同时看到两行：zlib support => enabledStream Wrapper => compress.zlib:// - 若 CLI 有、Web 没有，说明 php-fpm 或 Apache 加载的是另一个 php.ini，用
php --ini和phpinfo()中的 “Loaded Configuration File” 路径比对
加运行时兜底，避免功能雪崩
即使配置正确，线上环境仍可能因部署差异导致扩展不可用。在调用压缩逻辑前主动防御：
- 不要等
gzcompress()报错才处理，提前判断： if (!function_exists('gzcompress')) {<br> error_log('PHP 5.6.40 zlib extension missing');<br> throw new RuntimeException('Compression unavailable');<br>}- 更实用的做法是 fallback：小数据跳过压缩，大数据改用
base64_encode($data)传输，保证主流程不中断
