bz2扩展必须在编译PHP时启用或手动追加：先装bzip2-devel/libbz2-dev，phpenv install需加--with-bz2；已安装版本须源码编译ext/bz2并配置php.ini，最后用php -r "var_dump(function_exists('bzopen'));"验证函数可用性。
phpenv 本身不管理扩展，bz2 扩展必须在编译 PHP 时启用，或在已安装的 PHP 版本中手动追加 —— 直接用 phpenv install 安装的版本默认不含 bz2，除非你指定 --with-bz2。
phpenv install 时启用 bz2 需显式加 --with-bz2
phpenv 的 phpenv install 命令底层调用的是 php-build，它支持传入 configure 参数。bz2 不是默认启用的扩展，系统必须已安装 bzip2-devel（CentOS/RHEL）或 libbz2-dev（Debian/Ubuntu），否则编译会失败。
- 确认系统依赖已装：
sudo apt install libbz2-dev或sudo yum install bzip2-devel - 安装 PHP 时加上参数：
phpenv install 7.4.33 --configure-options="--with-bz2" - 如果报
configure: error: Please reinstall the BZip2 distribution，说明系统缺开发头文件，不是缺 bzip2 命令本身 - 安装完成后，用
php -m | grep bz2验证，或检查php -i | grep "bz2 support"是否显示 enabled
已安装的 phpenv PHP 版本如何追加 bz2 扩展
phpenv 管理的 PHP 若已编译完成且未带 bz2，不能靠改 php.ini 启用 —— 因为 bz2.so 根本不存在。你必须回到源码目录手动编译扩展模块：
- 找到该 PHP 版本源码路径，通常在
$(phpenv root)/sources/7.4.33/（版本号替换成你实际用的） - 进入
ext/bz2/子目录，执行：$(phpenv root)/shims/phpize - 再运行：
./configure --with-php-config=$(phpenv root)/shims/php-config --with-bz2 -
make && sudo make install，成功后会输出类似/home/xxx/.phpenv/versions/7.4.33/lib/php/extensions/no-debug-zts-20190902/bz2.so - 编辑该版本的 php.ini（路径通常为
$(phpenv root)/versions/7.4.33/etc/php.ini），添加：extension=bz2.so - 注意：不要写绝对路径，
extension_dir必须指向正确的 modules 目录，否则加载失败
验证 bz2 函数是否可用，别只看 phpinfo()
phpinfo() 显示 bz2 模块存在 ≠ 函数能用。常见失效场景是 ZTS（线程安全）不匹配，或扩展被禁用但没报错。
立即学习“PHP免费学习笔记（深入）”；
- 最简验证方式：
php -r "var_dump(function_exists('bzopen'));"—— 返回bool(true)才算真正就绪 - 测试解压逻辑时，
bzopen()失败返回false，不是抛异常，必须用or die()或显式判断 - Windows 下若用 NTS 版 PHP，却加载了 TS 编译的
bz2.dll，函数会存在但调用立即 segfault，这类问题只能换匹配版本 - 用
php -v看到with bzip2字样，才是 configure 阶段真正启用了，比 php.ini 配置更可靠
真正麻烦的从来不是“怎么加”，而是“加完发现函数调不了”——根源往往在编译时的 --with-bz2 和运行时的 so 文件 ABI 兼容性上，这两者不一致，比 php.ini 写错更难排查。
