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

关闭模块处理在周围的位置。

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 开;

定义在转换GIF图片或指定调色板的PNG图片时是否保持透明度。透明度的损失会导致图片质量更好。PNG的阿尔法通道透明度始终保留。

image_filter_webp_quality 80;

设置转换为WebP图片的期望质量。可接受的值范围是1到100。较低的值通常意味着较低的图片质量和较少的数据传输。参数值可以包含变量。