phpEnv 不支持 WebP 自动转换，因其精简版 Nginx 缺失 ngx_http_image_filter_module 和 libwebp；唯一可行方案是预生成 .webp 文件并用 try_files + map 实现静态协商分发。
phpEnv 默认不支持 WebP 自动转换，它用的是精简版 Nginx（通常为 1.18 或 1.20），既没编译 ngx_http_image_filter_module，也没链接 libwebp。想让它“自动转换”JPEG/PNG 为 WebP，必须手动补全模块并重编译——但 phpEnv 不提供编译入口，这条路走不通。
phpEnv 的 Nginx 缺少 image_filter 和 libwebp 支持
phpEnv 安装包里的 Nginx 是预编译二进制，nginx -V 会显示 configure arguments 中不含 --with-http_image_filter_module 和 --with-libwebp。这意味着：image_filter_webp on、image_filter resize 等指令直接报错；try_files $uri.webp 也只能做静态文件回退，无法动态转码。
- 执行
nginx -t时若配置中出现image_filter相关指令，会提示 “unknown directive” -
load_module modules/ngx_http_image_filter_module.so会失败，因为该文件根本不存在 - 即使强行拷贝第三方模块，也会因 ABI 不兼容或缺少依赖（如
libgd、libwebp）而加载失败
可行方案：只做 WebP 静态协商分发（无需编译）
放弃“自动转换”，改用最轻量、最稳定的方式：提前用 cwebp 把原始图片批量生成 .webp 文件，再靠 Nginx 的 try_files + map 实现按需返回。这是 phpEnv 唯一开箱即用的 WebP 方案。
- 在网站根目录下，对每张
photo.jpg执行：cwebp -q 80 photo.jpg -o photo.jpg.webp - 进入 phpEnv 面板 → 网站 → 配置文件，在
server块顶部加入：map $http_accept $webp_suffix { default ""; "~*webp" ".webp"; } - 找到图片 location（如
location ~ .*\.(jpg|jpeg|png|gif)$），把里面的try_files行改为：try_files $uri$webp_suffix $uri =404; - 在同一 location 内加一行：
add_header Vary Accept; - 确保 MIME 类型已注册：在
http块的types { }里有image/webp webp;
为什么别碰“自动转码”或 OpenResty 替换
phpEnv 是 Windows 下的便携式环境，底层是 MinGW/MSYS2 模拟 POSIX，不是真实 Linux。所有需要源码编译、动态链接库、Lua JIT 或 GD 库的操作都会失败或不可维护。
立即学习“PHP免费学习笔记（深入）”；
- 替换为 OpenResty？Windows 版 OpenResty 不支持
image_filter模块（官方明确说明） - 自己编译带
image_filter的 Nginx？MinGW 下libwebp编译极不稳定，且 phpEnv 的启动脚本不识别自定义 bin 路径 - 用 PHP 回退生成 WebP？会显著拖慢首图加载，且并发高时易触发超时，违背“提升性能”的初衷
真正省事又可靠的做法，就是把 WebP 当作静态资源来管：用脚本批量转好、放对位置、配好 try_files 和 Vary。那些“实时转换”的炫技功能，在 phpEnv 这种轻量环境里，本质是给自己埋雷。
