必须核对php、phpize、php-config三者版本一致，否则扩展编译或加载失败；执行which php、php -v、which phpize、phpize --version确认主版本号匹配，不一致需切换环境或重装对应php-devel包。
确认PHP版本和phpize路径是否匹配
编译前不核对版本，大概率会遇到 phpize 报错或扩展加载失败。必须用当前运行的 PHP 对应的 phpize，而不是系统默认或旧版残留的。
执行以下命令确认：
which php php -v which phpize phpize --version
三者输出的 PHP 主版本号（如 7.4、8.1、8.3）必须一致。若不一致，需切换到对应版本的 SCL 环境（如 CentOS/RHEL 的 scl enable php81 bash），或重新安装匹配的 php-devel 包。
下载并编译php-ext-brotli源码
直接克隆带子模块的完整仓库，避免后续因缺少 libbrotli 头文件导致 ./configure 失败：
立即学习“PHP免费学习笔记（深入）”；
git clone --recursive --depth=1 https://github.com/kjdev/php-ext-brotli.git cd php-ext-brotli phpize
执行 ./configure 时注意两点：
- 若系统已装
libbrotli-dev（Debian/Ubuntu）或brotli-devel（RHEL/CentOS），可直接./configure - 若提示
cannot find brotli library，说明 pkg-config 找不到库，需手动指定路径，例如：./configure --with-libbrotli=/usr/local/lib
接着执行：
make && sudo make install
成功后会输出类似 Installing shared extensions: /usr/lib64/php/modules/ 的路径，记下该路径，后面配 php.ini 时要用。
启用扩展并验证是否加载成功
在正确的 php.ini 中添加一行（不是 php.d/brotli.ini，除非你明确知道它被包含）：
extension=brotli.so
注意：brotli.so 文件名必须与 make install 输出的文件名完全一致；若路径不在默认扩展目录，需写绝对路径，例如：
extension=/usr/lib64/php/modules/brotli.so
重启 PHP-FPM 或 Apache 后，执行：
php -m | grep brotli php -i | grep "brotli.output_compression"
若第一条无输出，说明未加载；若第二条返回 brotli.output_compression => 0 => 0，说明已加载但未启用压缩功能。
在代码中启用Brotli输出压缩
仅加载扩展不会自动压缩响应体，必须显式开启：
- 全局启用（推荐放在入口文件顶部，且不能有任何输出前）：
ini_set('brotli.output_compression', 1); - 设置压缩级别（0–11，默认 -1 相当于 11）：
ini_set('brotli.output_compression_level', 6); - 浏览器必须发送
Accept-Encoding: br，Nginx/Apache 才会透传；若用 Brotli + Nginx，brotli.output_compression应设为0，交由 Nginx 统一处理，否则可能重复压缩或冲突
验证是否生效：用 curl 查看响应头：curl -H "Accept-Encoding: br" -I https://yoursite.com/test.php，返回中应含 Content-Encoding: br 和 Vary: Accept-Encoding。
真正容易被忽略的是：Nginx 已启用了 Brotli，又在 PHP 层开了 brotli.output_compression，结果响应头混乱、客户端解压失败——这种叠加配置比没开还麻烦。
