phpEnv默认不支持WebP，需手动配置MIME类型、用try_files硬编码分发，并依赖PHP GD（需启用WebP支持）预生成.webp文件，无法运行时自动转换。
phpEnv 默认不开启 WebP 支持，也无法自动转换图片；它不内置 ngx_http_image_filter_module 或 WebP 编解码能力，更不提供运行时转码功能。所谓“自动转换”，必须靠外部工具预生成 + Nginx 条件分发，或换用 OpenResty + Lua 方案 —— phpEnv 的 Nginx 是精简版，连 load_module 都被裁掉，硬加模块会启动失败。
确认 phpEnv 的 Nginx 是否支持 WebP 基础识别
phpEnv 的 Nginx 通常不含 image/webp MIME 类型声明，浏览器即使请求 .webp 文件，也可能收到 text/plain 或 404。必须手动补全：
- 打开 phpEnv 安装目录下的
Nginx/conf/nginx.conf - 在
http { }块内找到types { }区域（若无则新建） - 插入一行：
image/webp webp; - 保存后重启 phpEnv 的 Nginx 服务（不是重载）
验证方式：直接访问一个已存在的 xxx.webp 文件，用 curl 检查响应头：curl -I http://localhost/xxx.webp，应看到 Content-Type: image/webp。否则说明 MIME 未生效。
用 try_files 实现 WebP 自适应分发（前提：WebP 文件已存在）
phpEnv 不支持 if 嵌套在 location 中（会报错），也不能用 map（部分旧版编译时未启用 --with-http-map-module）。唯一可靠的方式是硬编码判断 + 多级 try_files：
立即学习“PHP免费学习笔记（深入）”；
location ~* \.(jpg|jpeg|png|gif)$ {
add_header Vary Accept;
# 优先尝试 .webp 后缀（如 photo.jpg → photo.jpg.webp）
try_files $uri.jpg.webp $uri.jpeg.webp $uri.png.webp $uri.gif.webp $uri =404;
expires 1y;
add_header Cache-Control "public, immutable";
}注意点：
- 文件命名必须严格匹配：原图
banner.png对应的 WebP 必须叫banner.png.webp，不能是banner.webp - 不加
map就没法动态拼后缀，所以要穷举所有可能组合，否则 fallback 会失效 -
try_files顺序不能错：WebP 变体必须放在原图前面，且每个都要写全扩展名
批量生成 WebP 文件（替代运行时转换）
phpEnv 没有 cwebp 或 ImageMagick，但你可以用 PHP 脚本生成 WebP，前提是 PHP 编译时启用了 GD 并支持 WebP：
- 执行
php -r "var_dump(gd_info()['WebP Support']);"，返回true才能继续 - 写一个转换脚本（例如
gen-webp.php），遍历./uploads/下的 JPG/PNG，调用imagecreatefromjpeg()+imagewebp() - 关键细节：
imagewebp($img, null, 85)输出到浏览器，要存文件得传路径；且 PNG 透明通道需先调imagealphablending($img, true)和imagesavealpha($img, true) - 生成后的文件建议统一用
.webp后缀（如photo.jpg→photo.jpg.webp），避免改 Nginx 配置
别指望 phpEnv 自动帮你转——它没那个 runtime 能力，也没图形处理依赖库。
为什么不要碰 image_filter 或 Lua 方案
phpEnv 的 Nginx 二进制是静态链接、阉割版：
-
ngx_http_image_filter_module默认未编译，load_module modules/ngx_http_image_filter_module.so会直接导致 Nginx 启动失败 - 没有
libwebp开发包，就算重编译也缺依赖，且 phpEnv 不提供编译入口 - Lua 支持需要 OpenResty，而 phpEnv 绑定的是标准 Nginx，二者不兼容
强行折腾只会让 Nginx 报 unknown directive "image_filter" 或段错误。WebP 在 phpEnv 里只有一条路：人肉生成 + Nginx 硬匹配。
