XAMPP Windows 版（8.0+）默认已编译 bz2 扩展但被注释，无需下载 DLL 或手动复制文件；需取消 php.ini 中 extension=bz2 的分号注释，确保路径与 phpinfo() 显示的“Loaded Configuration File”一致，并重启 Apache 验证。
确认bz2扩展是否已预置
XAMPP Windows 版（8.0+）默认已编译 bz2 扩展，但处于注释状态，**不需要下载 DLL 或手动复制文件**。它不像 mongodb 或 yaml 那样需额外安装，也不依赖 OpenSSL 或 ICU 等外部库。
验证方式：打开命令行，运行 php -m | findstr bz2。若无输出，说明未启用；若有 bz2，说明已加载（但可能仍需检查 Web 模式是否一致）。
注意：php -v 和 XAMPP 控制面板显示的 PHP 版本必须与 phpinfo() 中 “Loaded Configuration File” 路径下的实际配置一致——很多人改了错的 php.ini，导致始终不生效。
修改正确的 php.ini 并启用 extension=bz2
在浏览器中访问 http://localhost/info.php（内容为 <?php phpinfo(); ?>），找到 “Loaded Configuration File” 行，记下完整路径（如 C:\xampp\php\php.ini 或 C:\xampp\php\php-8.3\php.ini）。
用文本编辑器打开该文件，搜索 ;extension=bz2（不是 php_bz2.dll，也不是带路径的写法），取消分号注释：
extension=bz2
常见错误点：
- 误写成
extension=php_bz2.dll→ XAMPP 的extension_dir已预设，硬写路径会失败 - 改了控制面板里“Config → PHP”打开的
php.ini，但 Apache 实际加载的是另一份 → 一定以phpinfo()显示的路径为准 - 保存时用了 UTF-8 BOM 编码 → 导致 Apache 启动报错或页面空白，建议用 Notepad++ 选“编码 → ANSI”或“UTF-8 无 BOM”保存
重启 Apache 并验证 bz2 函数是否可用
仅保存 php.ini 不够，必须在 XAMPP 控制面板中彻底停止再启动 Apache（不是“Restart Module”）。否则扩展不会加载。
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
创建测试脚本 test_bz2.php 放入 htdocs：
<?php
var_dump(extension_loaded('bz2'));
var_dump(function_exists('bzcompress'));
$data = 'hello world';
$compressed = bzcompress($data, 9);
var_dump(strlen($data), strlen($compressed));
?>
访问 http://localhost/test_bz2.php，应看到：
-
bool(true)两次（扩展加载 + 函数存在） - 压缩后长度明显变小（
bzcompress返回二进制数据，不能直接 echo）
如果出现 Call to undefined function bzcompress()，说明扩展没加载成功；若页面空白，检查 php.ini 是否有语法错误（比如多了一个等号、引号不匹配）或被杀毒软件拦截了 php_bz2.dll。
使用 bz2 函数处理文件的注意事项
bz2 扩展提供的是底层压缩函数（bzcompress/bzdecompress），不支持直接读写 .bz2 文件流（像 gzopen 那样）。要处理文件，得手动读取、压缩、写入：
$raw = file_get_contents('input.txt');
$compressed = bzcompress($raw, 9);
file_put_contents('output.bz2', $compressed);
解压同理：
$bzdata = file_get_contents('output.bz2');
$plain = bzdecompress($bzdata);
关键限制：
-
bzcompress第二个参数是压缩级别（0–9），不是 0–99 —— 文档里写的 0–99 是旧版误导，XAMPP 当前 PHP 版本只接受 0–9 - 输入数据不宜过大（>100MB），PHP 内存限制可能触发
Fatal error: Allowed memory size exhausted，需分块处理 - 不支持流式压缩（
stream_wrapper_register无法注册bz2://协议），别试图用fopen('compress.bzip2://file.bz2', 'r')
真正容易被忽略的是：Windows 下某些杀软会静默隔离 php_bz2.dll，即使扩展名正确、路径对、php.ini 无误，Apache 也可能启动失败且日志里只报 “The specified module could not be found”。此时要查 Windows 事件查看器或杀软隔离区。
