xampp 自带 php 默认不编译 bzip2 支持，需先执行 /opt/lampp/bin/php -m | grep bz2 验证；无输出则未启用，linux/macos 下无法仅靠 php.ini 启用，必须使用系统 php 或改用外部命令替代。
确认 XAMPP 自带的 PHP 是否已编译 Bzip2 支持
XAMPP 的 PHP 默认不启用 bz2 扩展，即使系统装了 bzip2-devel，XAMPP 自带的二进制版 PHP 也不包含该扩展——它不是靠运行时安装就能启用的模块，而是必须在编译 PHP 时用 --with-bz2 指定。所以第一步不是改 php.ini，而是查清楚你手头的 XAMPP 版本是否支持。
执行以下命令验证：
cd /opt/lampp/bin ./php -m | grep bz2
如果无输出，说明未启用；若返回 bz2，则跳过编译步骤，直接启用即可。多数 XAMPP（尤其是 8.0+ 版本）仍默认禁用该扩展，需手动开启。
- Windows 用户：打开
\xampp\php\php.ini，取消注释;extension=php_bz2.dll→ 改为extension=php_bz2.dll - Linux/macOS 用户：XAMPP 不提供
php_bz2.so预编译文件，extension=bz2或extension=php_bz2.so会直接报错 —— 必须自行编译，或换用系统原生 PHP - 编译前提：确保系统已安装
bzip2-devel（CentOS/RHEL）或libbz2-dev（Debian/Ubuntu），否则./configure --with-bz2会失败
启用后验证 bzopen() 和 bzcompress() 是否可用
启用扩展后重启 Apache（/opt/lampp/lampp restart），再用脚本快速验证函数是否存在：
<?php var_dump(function_exists('bzopen'));
var_dump(function_exists('bzcompress'));
?>
两个都返回 true 才算真正就位。常见失败点：
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
-
bzopen()只接受"r"或"w"模式，传"rb"、"w+"会静默失败或警告 -
bzcompress()返回的是二进制乱码字符串，不能直接 echo 显示，要用bin2hex()或写入文件后用bzread()读取验证 - PHP 错误报告级别太低时，
bzopen()权限不足（如/tmp不可写）可能只返回false而不抛异常
压缩文件时别混淆 bz2、zlib 和 zip 三类扩展
XAMPP 用户常把这三者混用，但它们用途和接口完全不同：
-
bz2：只处理单个数据流（字符串或文件），无目录打包能力；函数是bzopen()/bzcompress()；适合小文本高压缩比场景 -
zlib：提供gzencode()/gzdeflate()，也只压缩单块数据；Apache 的 Gzip 压缩（mod_deflate）底层用的就是 zlib，不是 bz2 -
zip：真正用于打包文件夹，依赖ZipArchive类；需启用php_zip.dll（Windows）或编译--enable-zip（Linux）
例如想把整个 /htdocs/myapp 打成 .tar.bz2，bz2 扩展完全帮不上忙——得用系统 tar 命令配合 exec()，或先 ZipArchive 打包再调用外部 bzip2 命令。
Linux 下手动编译启用 bz2 扩展的实际限制
理论上你可以下载 XAMPP 对应的 PHP 源码，用 /opt/lampp/bin/phpize 编译 bz2，但实操中几乎不可行：
-
/opt/lampp/bin/phpize通常缺失autoconf，需额外装系统包，且版本必须严格匹配 XAMPP 内置 PHP 的构建环境 - 编译出的
bz2.so很可能因 ABI 不兼容而无法加载（PHP Warning: Invalid library (maybe not a PHP library)） - XAMPP 官方不提供 PHP 源码或构建配置，你无法复现其
--prefix和线程模型（ZTS/non-ZTS）
真正可行的路径只有两条：要么换用系统 PHP（apt install php-bz2），要么接受 XAMPP 当前版本不支持 bz2，改用 gzencode() 或外部命令替代。
