如果要使用这些模块,则必须在编译时指定相关的编译参数。
这个模块可以在传递图片文件(">JPEG, GIF和PNG)时对其做一些改变 。
要使用这个模块必须在编译时指定下列编译参数(0.7.54后版本可用):
--with-http_image_filter_module
这个模块依赖于libgd,推荐使用近期的版本。
示例配置:
location /img/ { proxy_pass http://backend; image_filter resize 150 100; error_page 415 = /empty;} location = /empty { empty_gif;}
指令
image_filter
语法:image_filter (test|size|resize width height|crop width height)
默认值:none
使用字段:location
指定需要变化的类型。如下:
test: 核实应答确实为一个图片格式,否则返回415错误。 size: JSON格式的图片信息,如:{ "img" : { "width": 100, "height": 100, "type": "gif" } }
或许是一个错误:
{} resize:减少图片到指定
大小。 crop:减少图片到指定大小并对超过大小的部分进行裁剪。
image_filter_buffer
语法:image_filter_buffer size
默认值:1M
使用字段:http, server, location
读取图片的最大值。
image_filter_jpeg_quality
语法:image_filter_jpeg_quality [0…100]
默认值:75
使用字段:http, server, location
设置处理JPEG图片时损失的质量比率,最大推荐值为95。
image_filter_transparency
语法:image_filter_transparency on|off
默认值:on
使用字段:http, server, location
这个指令允许你在GIF和基于调色板的PNG中禁用图像透明,以提高图像质量。
无论是否设置这个参数,真色彩PNG的alpha通道总是存在。
注意:灰度PNG并未经过测试,它将作为真色彩进行处理。