phpEnv 的 Nginx 默认不识别 .webp，需手动在 types 中添加 image/webp webp；动态转换需 image_filter 模块（通常未编译），静态方案用 map + try_files 匹配 .jpg.webp 等文件，并用 PHP 脚本批量生成 WebP。
phpEnv 默认的 Nginx 不识别 .webp 后缀，也不做内容协商，直接访问 .webp 文件会返回 404 或触发下载——这不是浏览器问题，是服务器没声明 MIME 类型、没启用对应模块。
确认 phpEnv 的 Nginx 是否支持 WebP 响应
phpEnv 多数基于精简版 Nginx（如 1.18/1.20），默认不带 ngx_http_image_filter_module，也未预编译 libwebp 支持。这意味着：
- 你不能用
image_filter_webp on动态转图 -
try_files $uri.webp $uri可以用，但前提是.webp文件已存在且 Nginx 能正确返回它 - 若请求
/a.jpg时想自动返回/a.jpg.webp，必须靠静态文件匹配 +try_files，而非运行时转换
执行 nginx -V 2>&1 | grep -o "image_filter" 查看是否含该模块；若无输出，说明不可用动态转换，只能走静态 WebP 文件路线。
在 phpEnv 中让 .webp 文件可被正常访问
这是最基础、最稳的一步：确保浏览器请求 xxx.webp 时，Nginx 返回 Content-Type: image/webp 而不是 application/octet-stream。
立即学习“PHP免费学习笔记（深入）”；
进入 phpEnv 的 Nginx 配置目录（通常是 D:\phpEnv\config\nginx\conf\nginx.conf 或类似路径），在 http 块内找到 types { ... } 区域，添加：
types {
image/webp webp;
}保存后重启 Nginx（通过 phpEnv 控制面板或命令行 nginx -s reload）。验证方式：访问一个已上传的 .webp 文件，用浏览器开发者工具检查响应头中的 Content-Type 是否为 image/webp。
配置按 Accept 头自动回退到 .webp（静态文件方案）
这是实现“同一 URL 返回不同格式”的关键，依赖 Nginx 的 map 和 try_files，不依赖 PHP 或额外模块。
在站点对应的 server 块中（如 D:\phpEnv\wwwroot\your-site\nginx.conf），插入以下配置：
map $http_accept $webp_suffix {
"~*webp" ".webp";
default "";
}
<p>server {</p><h1>... 其他配置</h1><pre class='brush:php;toolbar:false;'>location ~* \.(jpg|jpeg|png|gif)$ {
add_header Vary Accept;
try_files $uri$webp_suffix $uri =404;
}}
注意点：
-
$uri$webp_suffix会尝试匹配/photo.jpg.webp（即原图名 +.webp后缀），不是/photo.webp - 所以你必须提前把
photo.jpg对应的 WebP 文件命名为photo.jpg.webp，放在同目录 - 若想用
photo.webp，需改写为try_files $uri.webp $uri =404，但此时需确保所有 WebP 文件统一用.webp后缀，且原始图片与 WebP 文件名不重叠（避免误覆盖）
用 PHP 批量生成 WebP 文件（替代 cwebp 命令）
phpEnv 自带 PHP（通常 ≥7.4），且默认开启 gd 和 webp 支持（PHP 7.1+ 内置 imagecreatefromwebp/imagewebp），可直接写脚本批量转图。
新建 convert-to-webp.php 放在网站根目录，内容如下：
<?php
$dir = __DIR__ . '/uploads/';
$files = glob($dir . '*.{jpg,jpeg,png}', GLOB_BRACE);
<p>foreach ($files as $file) {
$info = pathinfo($file);
$webpFile = $info['dirname'] . '/' . $info['filename'] . '.' . $info['extension'] . '.webp';</p><pre class='brush:php;toolbar:false;'>if (file_exists($webpFile)) continue;
$img = null;
if (stripos($file, '.jpg') !== false || stripos($file, '.jpeg') !== false) {
$img = imagecreatefromjpeg($file);
} elseif (stripos($file, '.png') !== false) {
$img = imagecreatefrompng($file);
}
if ($img) {
imagewebp($img, $webpFile, 85); // 质量 85
imagedestroy($img);
echo "✅ {$info['basename']} → {$info['basename']}.webp\n";
}} ?>
访问该脚本一次即可生成所有 .jpg.webp / .png.webp 文件。后续只需定期运行或集成进上传逻辑。
容易忽略的一点：imagewebp() 在 Windows 下可能因 GD 编译缺失 WebP 支持而失败——此时需确认 phpinfo() 页面中 “WebP Support” 显示为 enabled；若为 disabled，则需换用 cwebp.exe 命令行工具或改用 ImageMagick。
