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

phpenv默认不支持webp，需手动配置mime类型、用try_files硬编码分发，并依赖php gd（需启用webp支持）预生成.webp文件，无法运行时自动转换。

phpenv配置nginx支持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：

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";
}

注意点：

Nginx Hosting

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

下载

文件命名必须严格匹配：原图 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 硬匹配。