ngx_http_image_filter_module模块(0.7.54+)是一个将图片转为JPEG、GIF、PNG格式的过滤器。
该模块默认不会构建,需要通过–with-http_image_filter_module参数开启。
该模块使用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
语法:image_filter off
image_filter test
image_filter size
image_filter rotate 90 | 180 | 270
image_filter resize width height
image_filter crop width height
默认:image_filter off
上下文:location
设置转换操作类型:
off
关闭转换
test
确保响应图片是JPEG、GIF或PNG格式,否则返回415错误码。
size
以JSON格式输出图片的信息,例如:
{ "img" : { "width": 100, "height": 100, "type": "gif" } }
如果有错误,输出:
{}
rotate
顺时针旋转指定角度。参数值可以包含变量。这个模式可以单独使用也可以和resize、crop变换同时使用。
resize width height
按比例对图像进行缩放,可以只指定一个尺寸,另一个尺寸用“-”。如果遇到错误,服务器返回415错误码。参数值可以包含变量。当与rotate参数一同使用时,旋转操作发生在缩放之后。
crop width height
按比例裁剪图片,可以只指定一个尺寸,另一个尺寸用“-”。如果遇到错误,服务器返回415错误码。参数值可以包含变量。当与rotate参数一同使用时,旋转操作发生在裁剪之前。
image_filter_buffer
语法:image_filter_buffer size
默认:image_filter_buffer 1M
上下文:http, server, location
设置读取图片的最大缓冲区大小。当超过缓冲区大小时,服务器返回415错误码。
image_filter_interlace
语法:image_filter_interlace on | off
默认:image_filter_interlace off
上下文:http, server, location
版本:1.3.15+
如果开启此功能,最终的图像是交错的。对于JPEG,最终图片是“渐进式JPEG”格式。
image_filter_jpeg_quality
语法:image_filter_jpeg_quality quality
默认:image_filter_jpeg_quality 75
上下文:http, server, location
设置转为JPEG图像的质量。接受的值从1到100。较小的值意味着低质的图片质量和更少的数据传输量。最大建议的值是95。参数可以包含变量。
image_filter_sharpen
语法:image_filter_sharpen percent
默认:image_filter_sharpen 0
上下文:http, server, location
增加最终图片的锐度。这个百分比可以超过100。0值禁用此功能。参数可以包含变量。
image_filter_transparency
语法:image_filter_transparency on|off
默认:image_filter_transparency on
上下文:http, server, location
决定在转换GIF或PNG图片带有调色板定义的颜色时,透明是否会保留。丢失透明度可以是图片得到更好的质量。PNG的Alpha通道的透明总是会保留。