phpEnv配置Nginx支持WebP图片 phpEnv图片格式转换-php教程-PHP中文网

phpenv 的 nginx 默认不识别 .webp，需手动在 types 中添加 image/webp webp；动态转换需 image_filter 模块（通常未编译），静态方案用 map + try_files 匹配 .jpg.webp 等文件，并用 php 脚本批量生成 webp。

phpenv配置nginx支持webp图片 phpenv图片格式转换

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。

进入 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），插入以下配置：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

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';<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。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！