phpEnv默认不编译bz2扩展，需通过phpenv install --reinstall 8.2.12 +bz2重装启用，或手动进入~/.phpenv/versions/8.2.12/src/ext/bz2目录，用对应版本的phpize和php-config编译安装，再在~/.phpenv/versions/8.2.12/etc/php.ini中添加extension=bz2.so。
phpEnv 本身不自带 bz2 扩展，它只是 PHP 版本管理工具（类似 phpbrew），所有扩展都得靠你手动编译启用。直接改 php.ini 加 extension=bz2.so 会报错“找不到文件”，因为 phpEnv 默认不编译这个扩展。
确认当前 phpEnv 使用的 PHP 源码是否含 ext/bz2
phpEnv 安装 PHP 时默认跳过非核心扩展。即使你用 phpenv install 8.2.12 装好了，ext/bz2 目录大概率是空的或根本没参与编译。
- 进你的 phpEnv PHP 源码目录，路径类似
~/.phpenv/versions/8.2.12/src/ext/bz2，检查是否存在且有config.m4文件 - 如果目录不存在，说明你当初安装时没带
+bz2参数，或者源码包被精简了 - 若存在但没编译过，下一步才真正开始
用 phpEnv 的 +bz2 参数重装 PHP（推荐）
这是最省事、最不容易出错的方式——让 phpEnv 在构建阶段就集成 bz2，而不是事后补。
- 先卸载旧版本：
phpenv uninstall 8.2.12 - 确保系统已装开发库：
sudo apt install libbz2-dev（Ubuntu/Debian）或sudo yum install bzip2-devel（CentOS/RHEL） - 重新安装并显式启用：
phpenv install --reinstall 8.2.12 +bz2 - 装完执行
php -m | grep bz2，应输出bz2
注意：不是所有 phpEnv 版本都支持 +bz2 语法；如果报错 “unknown option”，说明你用的是老版 phpEnv，得切到新版或改用手动编译。
立即学习“PHP免费学习笔记（深入）”；
手动为现有 phpEnv PHP 版本编译 bz2 扩展
适用于不能重装、或 phpEnv 不支持 +bz2 的情况。本质是复现 phpEnv 内部的编译逻辑。
- 进入对应 PHP 源码的
ext/bz2目录：cd ~/.phpenv/versions/8.2.12/src/ext/bz2 - 运行该版本专属的
phpize：~/.phpenv/versions/8.2.12/bin/phpize（路径必须精准匹配，不能用系统全局的） - 配置时指定正确的
php-config：./configure --with-php-config=~/.phpenv/versions/8.2.12/bin/php-config - 编译安装：
make && make install，成功后会提示类似Installing shared extensions: /home/user/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/ - 编辑该版本的
php.ini（路径通常为~/.phpenv/versions/8.2.12/etc/php.ini），加一行：extension=bz2.so
最容易踩的坑是混用不同 PHP 版本的 phpize 和 php-config，会导致生成的 .so 文件加载失败，错误信息通常是 undefined symbol: zend_string_init 这类 ABI 不兼容提示。
bz2 扩展启用后验证与常见误用
扩展加载成功 ≠ 函数能用。很多问题出在调用方式上，不是配置问题。
- 用
php -r "print_r(get_extension_funcs('bz2'));"确认函数列表，正常应包含bzopen、bzread、bzwrite、bzcompress等 -
bzopen()只接受"r"或"w"，不支持"rb"、"wr"或其它组合，传错会返回false且无明确错误提示 -
bzcompress()返回的是二进制字符串，不能直接 echo 输出，否则终端可能卡死或显示乱码；保存到文件要用file_put_contents()，读取要用bzdecompress() - 若用
bzopen()写入后再立即bzopen("r")读取，注意文件是否已 flush —— 有些系统缓存导致读不到最新内容，加fflush()没用，得bzclose()后再开
真正麻烦的从来不是“怎么装”，而是“装完发现函数返回 false 却不知道哪步错了”。建议每一步都用 php -m 和 get_extension_funcs() 交叉验证，别只盯着 php.ini 里有没有那行 extension。
