phpEnv默认不启用bz2扩展，必须先安装bzip2-devel依赖，再通过--with-bz2参数重新编译安装PHP，否则bzopen()等函数会报“Call to undefined function”错误。
phpEnv 默认不启用 bz2 扩展，必须手动编译安装并配置生效，否则调用 bzopen()、bzcompress() 等函数会直接报错 Call to undefined function。
确认系统已安装 bzip2-devel 依赖
phpEnv 是基于源码编译的 PHP 环境管理工具，bz2 扩展无法仅靠 extension=bz2.so 启用——它依赖系统级 bzip2 开发库。缺失时即使配置了扩展，make 阶段也会失败或生成无效 .so 文件。
- Ubuntu/Debian：
sudo apt install libbz2-dev - CentOS/RHEL/AlmaLinux：
sudo yum install bzip2-devel（或dnf install bzip2-devel） - macOS（Homebrew）：
brew install bzip2，并确保pkg-config能定位到头文件（必要时设export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig"）
phpEnv 编译时启用 --with-bz2
phpEnv 的 install 命令默认不带 --with-bz2，需显式传参。跳过这步会导致扩展根本未编译进 PHP 二进制中，后续任何 php.ini 配置都无效。
- 查看当前版本编译参数：
phpenv install --list | grep -A5 "your-version"，确认是否含--with-bz2 - 重新安装指定版本（例如 8.2.12）：
phpenv install 8.2.12 --configure-options="--with-bz2" - 若已安装过，不能“热添加”；必须卸载后重装：
phpenv uninstall 8.2.12 && phpenv install 8.2.12 --configure-options="--with-bz2" - 注意：部分 phpEnv 分支（如
phpenv/versions）可能需额外指定--with-libdir=lib64（RHEL系）或--with-bz2=/usr（macOS 自定义路径）
验证 bz2 扩展是否真正加载
即使 php.ini 里写了 extension=bz2，也不代表它在运行时被加载——常见原因是扩展路径错误、PHP 版本架构不匹配（如 ts/non-ts）、或扩展名拼写错误（bz2.so ≠ bz2.dll）。
立即学习“PHP免费学习笔记（深入）”；
- 执行：
php -m | grep bz2，有输出才说明加载成功；无输出则检查php --ini显示的配置文件路径，确认extension=bz2.so行未被注释且位于正确php.ini中 - 运行：
php -r "var_dump(function_exists('bzopen'));"，返回bool(true)才算可用 - 若报错
Unable to load dynamic library 'bz2.so'，用php-config --extension-dir查实际扩展目录，确认bz2.so文件存在且权限可读 - Windows 用户注意：
php.ini中应写extension=php_bz2.dll，不是bz2.dll，且 DLL 必须与 PHP TS/NTS 模式一致
使用 bz2 函数处理数据的注意事项
bz2 扩展适合高压缩率场景（如日志归档），但性能开销明显高于 zlib；它不支持 HTTP 输出压缩（zlib.output_compression 对 bz2 无效），也不能直接用于 API 响应流式压缩。
-
bzcompress($data, $level)的$level范围是 1–9，不是 0–9；传 0 会静默降为 1，传 >9 会被截断为 9 -
bzopen()只支持文件路径，不接受 URL 封装器（如http://或php://memory）；想压缩内存数据，必须先写临时文件或改用bzcompress() - 解压损坏的
.bz2文件时，bzdecompress()（注意函数名是bzdecompress，非bzuncompress）会直接Fatal error，无法用@抑制；务必先用file_get_contents()读全再校验 magic bytes（0x425A68） - 与 Python 或命令行
bzip2交互时，PHP 的bzcompress()输出是标准 bzip2 格式，可直接用bunzip2解压，无需额外转换
最易忽略的一点：phpEnv 管理多个 PHP 版本时，bz2 扩展只对当前 phpenv local 或 phpenv global 指定的版本生效，切版本后必须重新验证——很多人改完配置却仍在旧版本下测试，导致“明明配了却不工作”。
