xampp 自5.6起已预编译bz2扩展（php_bz2.dll），默认注释未启用；需在正确php.ini中取消;extension=php_bz2.dll的注释，并确认ext目录下存在该dll及依赖库，否则报“无法加载动态库”。
确认bz2扩展是否已内置但未启用
XAMPP 自 5.6 起多数版本都已预编译 bz2 扩展（php_bz2.dll），但它默认是注释掉的，不是缺失。直接去 php.ini 里找这一行：
;extension=php_bz2.dll
去掉前面的分号即可。注意：不要改错文件 —— XAMPP 的 php.ini 路径通常是 C:\xampp\php\php.ini（Windows）或 /Applications/XAMPP/xamppfiles/etc/php.ini（macOS），不是 Apache 的配置文件。
启动时报“无法加载动态库 bz2”怎么办
这类错误通常有三个原因：
-
php_bz2.dll文件确实不存在于C:\xampp\php\ext\目录下（检查是否存在） - PHP 版本与 DLL 不匹配（例如用 PHP 8.2 的
php_bz2.dll强行塞进 PHP 7.4 环境） - 依赖的系统级 DLL 缺失（如
libbz2.dll）—— XAMPP 通常自带，但如果手动替换过 PHP 目录，可能漏掉
验证方法：打开命令行，运行 php -m | findstr bz2（Windows）或 php -m | grep bz2（macOS/Linux）。没输出就说明没加载成功；报错则说明 DLL 加载失败，需查 Windows 事件查看器或终端具体错误。
bz2函数可用但压缩文件打不开？注意 bzopen 的模式限制
bzopen() 只接受 "r" 或 "w"，不支持 "rb"、"wb" 或 "a"。常见错误是写成：
$bz = bzopen('data.bz', 'wb'); // ❌ 报 Warning: bzopen(): invalid mode
正确写法只有：
$bz = bzopen('data.bz', 'w'); // ✅
另外，bzwrite() 写入后不会自动 flush，如果中途想读，必须先 bzclose() 再用 "r" 重新打开 —— 它不支持双工操作。这点和 fopen() 行为完全不同，容易踩坑。
macOS 上启用 bz2 需额外确认 libbz2.dylib 是否可链接
macOS 用户常遇到的问题是：明明 extension=bz2 已启用，php -m 却不显示，且 phpinfo() 里没有 bz2 模块。这时大概率是系统缺少 libbz2.dylib 或路径不对。
执行以下命令检查：
otool -L /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20220829/bz2.so
如果输出中出现 not found 对应的 libbz2.dylib，说明链接失败。解决方式有两种：
- 用
brew install bzip2安装，并通过install_name_tool重写 dylib 路径（较复杂） - 更稳妥的做法：直接使用 XAMPP 自带的完整包，不要混用 Homebrew PHP 或手动编译的扩展
最后提醒一句：XAMPP 的 bz2 扩展只提供基础压缩/解压能力，不支持流式解压超大文件或内存受限场景下的 chunk 处理 —— 如果业务需要这些，得换 zstd 或走外部命令调用 bzip2 二进制。
