phpEnv配置Nginx启用Brotli静态压缩 phpEnv性能极致-php教程-PHP中文网

nginx在phpenv中默认未编译ngx_brotli模块，配置brotli指令会报“unknown directive”错误；必须手动源码编译并添加--add-module，同时关闭gzip_static、确保.br文件权限为www:www、补全brotli_types text/html，并将动态php响应压缩等级设为1–3以平衡性能与压缩率。

phpenv配置nginx启用brotli静态压缩 phpenv性能极致

phpEnv里Nginx压根没编译ngx_brotli，配了也白配

phpEnv默认安装的Nginx是二进制包，不带ngx_brotli模块——你在nginx.conf里写再多brotli on，nginx -t都会报错unknown directive "brotli"。这不是配置问题，是模块缺失。

验证方式很简单：nginx -V 2>&1 | grep brotli，空输出就说明没集成。别信phpEnv面板里“Brotli开关”，那只是UI占位符。

必须手动编译：进/phpenv/nginx/src目录，用nginx -V查出原始configure arguments，末尾追加--add-module=/path/to/ngx_brotli
ngx_brotli要自己拉：先git clone --recurse-submodules https://github.com/google/ngx_brotli，再确保其子模块brotli/deps/brotli已完整下载
编译前删掉旧二进制备份：mv /phpenv/nginx/sbin/nginx /phpenv/nginx/sbin/nginx.bak，避免make install误覆盖

brotli_static always在phpEnv中容易权限炸锅

phpEnv默认以www用户跑Nginx worker，但预压缩的.br文件常由root或当前用户生成，导致Nginx读不到——此时brotli_static always会静默失败，既不返回.br，也不fallback到动态压缩，浏览器收到的是未压缩原始体。

检查方法：用ls -l /phpenv/nginx/html/js/app.js.br，确认属主是www:www；若不是，立刻chown www:www /phpenv/nginx/html/js/app.js.br。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

前端构建时生成.br文件，推荐用bro --quality 11 app.js -o app.js.br（注意bro命令需提前装好）
brotli_static always比on更激进：它强制优先找.br，找不到才动态压；而on只在有.br时用，没就不压——对phpEnv这种开发环境，always更省CPU
别漏配brotli_types：phpEnv常托管PHP生成的HTML，务必加上text/html，否则index.php响应永远不走Brotli

和phpEnv自带gzip共存时，必须关掉gzip_static

phpEnv默认启用了gzip_static on，它会抢在Brotli之前检查.gz文件。一旦app.js.gz存在，Nginx直接发gzip版，哪怕客户端支持br也绕不开——因为gzip_static和brotli_static互不感知，没有协商逻辑。

解决办法只有一条：gzip_static off;，然后靠brotli_static always接管所有静态资源。别试图“两个都开”，那是自找缓存混乱。

保留gzip on作为兜底没问题，但gzip_types建议精简为text/plain，只服务极老客户端
确认Accept-Encoding协商有效：用curl -H "Accept-Encoding: br" -I http://localhost/js/app.js，看响应头是否含Content-Encoding: br且Content-Length明显变小
phpEnv的Nginx日志默认不记上游编码，如需调试回源，得在log_format里加$upstream_http_content_encoding