模块 ngx_http_image_filter_module

ngx_http_image_filter_module 模块 (0.7.54+) 是一个过滤器，用于转换 JPEG、GIF、PNG 和 WebP 格式的图像。

此模块默认情况下未构建，应使用 --with-http_image_filter_module 配置参数启用。

此模块利用了 libgd 库。建议使用最新版本的库。

WebP 格式支持出现在 1.11.6 版本中。要转换此格式的图像，必须使用 WebP 支持编译 libgd 库。

location /img/ {
    proxy_pass   http://backend;
    image_filter resize 150 100;
    image_filter rotate 90;
    error_page   415 = /empty;
}

location = /empty {
    empty_gif;
}

image_filter off;

设置对图像执行的转换类型

off

在周围的 location 中关闭模块处理。

test

确保响应是 JPEG、GIF、PNG 或 WebP 格式的图像。否则，将返回 415（不支持的媒体类型）错误。

size

以 JSON 格式输出有关图像的信息，例如：

{ "img" : { "width": 100, "height": 100, "type": "gif" } }

如果发生错误，输出如下所示：

{}

rotate 90|180|270

将图像按指定度数逆时针旋转。参数值可以包含变量。此模式可以单独使用，也可以与 resize 和 crop 转换一起使用。

resize 宽度 高度

按比例将图像缩小到指定的尺寸。要仅按一个维度缩小，另一个维度可以指定为“-”。如果发生错误，服务器将返回代码 415（不支持的媒体类型）。参数值可以包含变量。当与 rotate 参数一起使用时，旋转发生在缩小**之后**。

crop 宽度 高度

按比例将图像缩小到较长的一侧尺寸，并裁剪另一侧的额外边缘。要仅按一个维度缩小，另一个维度可以指定为“-”。如果发生错误，服务器将返回代码 415（不支持的媒体类型）。参数值可以包含变量。当与 rotate 参数一起使用时，旋转发生在缩小**之前**。

image_filter_buffer 1M;

设置用于读取图像的缓冲区的最大大小。当大小超过限制时，服务器将返回错误 415（不支持的媒体类型）。

image_filter_interlace off;

如果启用，最终图像将交错。对于 JPEG，最终图像将采用“渐进式 JPEG”格式。

image_filter_jpeg_quality 75;

设置转换后的 JPEG 图像所需的 质量。可接受的值范围为 1 到 100。较小的值通常表示图像质量较低且传输的数据量也较少。最大推荐值为 95。参数值可以包含变量。

image_filter_sharpen 0;

增加最终图像的锐度。锐度百分比可以超过 100。零值禁用锐化。参数值可以包含变量。

image_filter_transparency on;

定义在转换 GIF 图像或使用调色板指定颜色的 PNG 图像时是否应保留透明度。透明度的丢失会导致图像质量更高。PNG 中的 alpha 通道透明度始终保留。

image_filter_webp_quality 80;

设置转换后的 WebP 图像所需的 质量。可接受的值范围为 1 到 100。较小的值通常表示图像质量较低且传输的数据量也较少。参数值可以包含变量。