phpEnv的Nginx无法实时转WebP，唯一可行方案是预生成WebP文件并配合map+try_files实现内容协商分发，需严格匹配文件名、配置Vary头及mime类型。
phpEnv 的 Nginx 不支持 image_filter_webp
phpEnv 是轻量级集成环境，打包的是精简版 Nginx（通常为 1.20+），ngx_http_image_filter_module 模块未内置，更不可能带 --with-libwebp 支持。你执行 nginx -V 2>&1 | grep -o with-http_image_filter_module，结果为空。这意味着：
• image_filter_webp on 会直接导致 Nginx 启动失败
• 所有依赖该指令的“动态转 WebP”配置都无效
• 宝塔那种重编译方案在 phpEnv 中不可行（无编译工具链、无源码、无权限）
唯一靠谱方案：map + try_files 预生成适配
这是 phpEnv 唯一能稳定落地的方式，前提是你要提前把 WebP 文件放好。核心就三件事：
• 在 http 块（不是 server！）顶部加 map 规则
• 在图片 location 里用 try_files 查找 $uri.webp
• 确保 mime.types 包含 image/webp webp;
操作步骤：
• 进入 phpEnv 安装目录 → nginx/conf/nginx.conf
• 在 http { 大括号最开头插入：
map $http_accept $webp_suffix {
default "";
"~*image/webp" ".webp";
}
• 找到类似 location ~ \.(jpg|jpeg|png|gif)$ { 的区块，在其内部加入：
立即学习“PHP免费学习笔记（深入）”；
add_header Vary Accept;try_files $uri$webp_suffix $uri =404;
• 检查 include mime.types; 是否存在，并确认 conf/mime.types 文件里有这一行：image/webp webp;
WebP 文件怎么放？命名必须严格匹配
phpEnv 不会帮你改文件名，try_files $uri.webp 会按原始请求路径拼接，比如请求 /uploads/photo.jpg，Nginx 就去找 /uploads/photo.jpg.webp ——不是 /uploads/photo.webp，也不是 /uploads/photo.jpg?webp。
所以批量生成时必须用这个命令（Linux/macOS）：
cwebp -q 80 /path/to/photo.jpg -o /path/to/photo.jpg.webp
Windows 用户可用 PowerShell：
Get-ChildItem "C:\www\uploads\*.jpg" | ForEach-Object { cwebp.exe -q 80 $_.FullName -o "$($_.FullName).webp" }
生成完务必检查文件权限（phpEnv 下 Nginx 以 www 用户运行），确保能读取 .webp 文件。
PHP 动态图或上传图无法走这套逻辑
像 thumb.php?w=300&src=abc.jpg 这类 PHP 脚本输出的图片，Nginx 根本不进静态 location，map 和 try_files 完全不触发。此时有两个选择：
• 前端用 <picture></picture> 标签手动 fallback（需 PHP 输出 WebP 版本并存盘）
• 改用 WebP Server Go 反代：启动一个 webp-server 进程，Nginx 把图片请求 proxy_pass 给它（注意：phpEnv 无 systemd，得用 nohup 或 supervisor 管理进程）
容易被忽略的关键点：Vary Accept 必须加，否则 phpEnv 自带的简易缓存或前端 CDN 会把 WebP 和原图混着缓存；map 必须写在 http 块顶层，写在 server 里会报错；.webp 文件若被误删或权限不对，Nginx 静默回退到原图，你根本看不到错误——得靠 Chrome DevTools 的 Network 面板看响应头 Content-Type 和实际返回的文件后缀来验证。
