phpEnv配置Nginx启用ETag缓存 phpEnv前端性能优化-php教程-PHP中文网

phpenv 下静态资源应禁用 etag 并启用 immutable 强缓存，html 则需确保 last-modified 准确；nginx 默认不支持内容哈希 etag，gzip_vary on 需关闭以防 cdn 回源率升高。

phpenv配置nginx启用etag缓存 phpenv前端性能优化

phpEnv 是 Windows 下的集成环境，底层用的是 Nginx + PHP-FPM，但它默认配置不启用 ETag，也不适配现代前端工程化缓存需求——直接开 etag on 反而容易引发缓存错乱或 CDN 回源冲突。

静态资源（JS/CSS/图片）必须禁用 ETag，改用 immutable 强缓存

phpEnv 默认把所有请求都扔给 PHP 处理（比如通过 try_files $uri @php），导致本该由 Nginx 直接服务的静态文件也被 PHP 中转。这会让 Nginx 无法基于文件元数据生成稳定 ETag，且 PHP 层面根本不会设置 Last-Modified 或 ETag 响应头。

先确保静态资源由 Nginx 直接响应：在 phpEnv 的 Nginx 配置中（通常是 C:\phpEnv\nginx\conf\vhosts\your-site.conf），找到 location ~ \.(js|css|png|jpg|gif|ico|svg|woff2?|ttf|eot)$ 块，删掉里面可能存在的 fastcgi_pass 或 try_files @php，只保留 expires 1y; 和 add_header Cache-Control "public, immutable";
显式关闭 ETag：etag off; —— 否则 Nginx 在代理模式下可能尝试对 PHP 返回的内容生成弱 ETag，但 PHP 没发 Last-Modified，结果 ETag 值为空或不一致
确认构建产物文件名含内容 hash（如 app.a1b2c3.js），否则 immutable 失效，浏览器仍会发起条件请求

HTML 入口文件不能强缓存，必须靠 ETag 或 Last-Modified 协商

phpEnv 环境下，index.html 往往是 PHP 动态生成的（比如读取模板、注入变量），此时 Nginx 的 etag on 不起作用——它只对真实磁盘文件或带 Last-Modified 响应头的代理响应生效。

前端设计优化skill

前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。

下载

若 HTML 是纯静态文件（即物理存在 C:\phpEnv\www\index.html），Nginx 默认已开启 etag on，无需额外配置；但需确认没被 etag off 覆盖
若 HTML 由 PHP 输出，必须在 PHP 代码里手动加头：header('Last-Modified: ' . gmdate('D, d M Y H:i:s', filemtime(__DIR__ . '/index.html')) . ' GMT');（前提是 PHP 读的是真实文件）
避免在 PHP 中用 header('ETag: "xxx"') 同时又开启 Nginx 的 etag on，二者冲突会导致 304 校验失败

phpEnv 的 Nginx 编译不含 ngx_http_etag_module，别折腾内容哈希 ETag

官方 phpEnv 打包的 Nginx 是精简版，没有第三方模块支持基于文件内容（MD5/SHA）生成 ETag。试图用 map + add_header 或 Lua 注入内容摘要，会触发同步文件读取，在 Windows 下尤其卡顿，且 phpEnv 不带 OpenResty。

不要写类似 add_header ETag "md5-$(md5sum $request_filename | cut -d' ' -f1)"; 这种伪代码——Nginx 不支持 shell 执行
不要尝试编译自定义模块：phpEnv 的 Nginx 依赖特定版本的 OpenSSL 和 zlib，替换二进制极易导致 SSL 或 gzip 失效
真正可控的做法只有两个：对带 hash 的静态资源关 ETag + 强缓存；对 HTML 保证 Last-Modified 准确性

最易被忽略的一点：phpEnv 的 Nginx 默认开启 gzip_vary on，而 Vary: Accept-Encoding 会干扰 CDN 对 ETag 的匹配逻辑，导致回源率升高。上线前务必检查并注释掉这一行。