Bz2 扩展在 phpEnv 中默认未启用，需手动开启：先确认当前 PHP 版本及 php.ini 路径，检查 bz2.so 是否存在，缺失则安装系统依赖并编译；在 php.ini 中添加 extension=bz2，最后用 php -m 和测试脚本验证功能。
Bz2 扩展在 phpEnv 中默认不启用，必须手动开启；否则调用 bzopen() 会报 “Call to undefined function bzopen()” 错误。
确认 phpEnv 当前 PHP 版本和扩展路径
phpEnv 是多版本 PHP 环境管理工具，不同 PHP 版本的配置彼此隔离。先查清你当前在用哪个版本：
- 运行
phpenv versions查看已安装版本（如7.4.33、8.1.25） - 运行
phpenv version确认当前激活版本 - 执行
php --ini找到 Loaded Configuration File 路径，例如：/home/username/.phpenv/versions/8.1.25/etc/php.ini - 扩展实际存放位置通常为：
/home/username/.phpenv/versions/8.1.25/lib/php/extensions/no-debug-zts-20210902/（后缀随 PHP ABI 版本变化）
检查系统是否已预装 bz2 扩展文件
phpEnv 本身不编译扩展，它依赖底层系统是否提供 bz2.so。先验证：
- 运行
ls /home/username/.phpenv/versions/8.1.25/lib/php/extensions/no-debug-zts-20210902/bz2.so—— 若存在，跳过编译，直接启用 - 若不存在，需确认系统级 bzip2 开发库是否就位：
dpkg -l | grep libbz2-dev（Ubuntu/Debian）或rpm -qa | grep bzip2-devel（CentOS/RHEL） - 缺失则安装：
sudo apt install libbz2-dev或sudo yum install bzip2-devel - 注意：phpEnv 管理的 PHP 若是源码编译安装的，还需重新进入对应 PHP 源码的
ext/bz2/目录，执行phpize && ./configure && make && sudo make install（但多数用户应优先用包管理器安装）
在 php.ini 中启用 bz2 扩展
找到对应版本的 php.ini，添加一行启用指令即可，无需重启系统服务（phpEnv 不依赖全局 Web 服务）：
立即学习“PHP免费学习笔记（深入）”；
- 打开
php.ini（路径来自php --ini输出） - 在文件末尾添加：
extension=bz2（不是bz2.so，phpEnv 下通常可省略 .so 后缀，自动识别） - 保存后，运行
php -m | grep bz2—— 应输出bz2；若无输出，说明路径或拼写有误 - 常见错误：
extension=bz2.so在某些 phpEnv + PHP 8.1+ 组合下会报 “Invalid library (appears to be a .so)”；改用extension=bz2即可解决 - 若仍失败，可尝试绝对路径：
extension=/home/username/.phpenv/versions/8.1.25/lib/php/extensions/no-debug-zts-20210902/bz2.so
验证 bz2 功能是否真正可用
仅 php -m 显示 bz2 不代表函数能用，必须实测读写逻辑：
- 新建测试脚本
test_bz2.php：
<?php
$test = 'hello world';
$bz = bzopen('/tmp/test.bz2', 'w');
if ($bz === false) {
die("bzopen failed\n");
}
bzwrite($bz, $test);
bzclose($bz);
$bz = bzopen('/tmp/test.bz2', 'r');
if ($bz === false) {
die("bzopen read failed\n");
}
$data = bzread($bz);
bzclose($bz);
var_dump($data === $test); // 应输出 bool(true)
?>
- 运行
php test_bz2.php，若报错 “Unable to open file”，检查/tmp写权限；若报 “BZ_SEQUENCE_ERROR”，说明文件损坏或模式错误（bzopen()只支持r或w，不支持rb、rw等） - 注意：
bzcompress()和bzdecompress()是字符串级函数，不依赖文件 I/O，但同样要求扩展已加载
最容易被忽略的是：phpEnv 切换版本后，php --ini 和 php -m 的结果可能不一致——务必每次都在目标版本下执行验证命令，而不是在 shell 默认 PHP 下检查。
