phpEnv 不支持 Brotli 压缩，因其 Nginx 未内置 ngx_brotli 模块且无法手动添加；Gzip 可用，但必须在 nginx.conf 的 http { } 块中正确配置并重启 phpEnv 服务。
phpEnv 不支持 Brotli 压缩，强行配置会失败或被忽略；Gzip 可用，但必须通过 Nginx 配置启用，不能依赖 php.ini 或 PHP 代码层。
phpEnv 的 Nginx 是否内置 ngx_brotli 模块？
不内置。phpEnv 是轻量级本地开发环境，其打包的 Nginx 二进制未编译 ngx_brotli，也未提供模块管理界面。尝试手动添加模块需重新编译 Nginx，但 phpEnv 缺乏构建工具链（如 gcc、pcre-dev、zlib-dev）和源码路径支持，实际不可行。
常见错误现象：
- 在
nginx.conf中写入brotli on;后，Nginx 启动报错：unknown directive "brotli" - 即使复制了
.so文件到 modules 目录，load_module仍会提示module not found或段错误
phpEnv 中正确启用 Gzip 的位置和方式
phpEnv 的 Nginx 配置文件位于：C:\phpEnv\nginx\conf\nginx.conf（Windows）或 ~/phpenv/nginx/conf/nginx.conf（macOS/Linux）。Gzip 必须写在 http { } 块内，且不能放在 server { } 内——后者会被忽略。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 取消注释或添加以下完整段落（确保在
http {大括号开始后、第一个server {前）：
gzip on; gzip_vary on; gzip_min_length 1024; gzip_comp_level 4; gzip_types text/plain text/css application/javascript application/json text/html image/svg+xml;
-
gzip_min_length 1024是关键：避免压缩过小响应（如空 JSON、304 响应），否则可能膨胀 - 不要启用
gzip_static on：phpEnv 默认不生成.gz预压缩文件，开启反而导致 404 - 改完后必须重启整个 phpEnv 服务（不只是 Nginx），否则配置不加载
为什么不能在 php.ini 或 PHP 脚本里“补救”Brotli？
因为 Brotli 是传输编码（Content-Encoding: br），必须由 Web 服务器协商并封装响应体；PHP 层无法直接设置该响应头并输出已压缩字节流——ob_gzhandler 只支持 gzip，zlib.output_compression 也仅限 gzip。
若强行在 PHP 中调用第三方 Brotli 库（如 robindev/brotli）并手动压缩 + 设置 header，会出现：
- 响应头
Content-Encoding: br与实际未压缩 body 不匹配 → 浏览器解压失败，白屏或乱码 - PHP 输出缓冲与 Nginx gzip 叠加 → 双重压缩，
Content-Encoding: gzip, gzip或更糟 - Nginx 默认会覆盖 PHP 设置的
Content-Encoding，尤其当启用了gzip_vary
Brotli 在 phpEnv 场景下本质是不可达目标；真正能落地的只有 Nginx 层 Gzip，且必须确认配置位置、最小长度、重启动作三者全部到位——漏掉任一环，Content-Encoding: gzip 就不会出现在响应头里。
