nginx中文文档-ngx_http_image_filter_module

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通道的透明总是会保留。

发表评论

电子邮件地址不会被公开。 必填项已用*标注

You must enable javascript to see captcha here!