Nginx系列：图片过滤处理

http_image_filter_module是Nginx提供的集成图片处理模块，支持nginx-0.7.54以后的版本，在网站访问量不是很高；磁盘有限不想生成多余的图片文件的前提下，就可以用它实时缩放图片，旋转图片，验证图片有效性以及获取图片宽高以及图片类型信息，由于是实时计算的结果，所以网站访问量大的话，不建议使用。

安装还是很简单的，默认http_image_filter_module模块是不会编译进nginx的，所以要在configure时候指定编译http_image_filter_module模块。另外http_image_filter_module模块需要依赖gd-devel的支持，可以使用yum install gd-devel先安装，如果未安装会报“/configure: error: the HTTP image filter module requires the GD library.”错误。

Nginx图片处理的优缺点

• 优点

（1）操作简单。通过简单配置，省去了后端裁剪程序的复杂性；

（2）实时裁剪。可以实时访问在线裁剪图片；

（3）灵活性强。后端程序裁剪图片时需要知道裁剪图片的尺寸和质量，使用nginx裁剪可以实时裁剪任意尺寸的图片；

（4）不占用硬盘空间；

• 缺点

（1）消耗CPU和内存，访问量大的时候就会给服务器带来很大的负担。(可以通过使用Nginx缓存和缓存服务器来解决)；

（2）功能不是很强大，支持的处理图片类型只包括JPEG、GIF、PNG or WebP；

0x01：安装http_image_filter_module

• 先安装gd-devel依赖库

yum install gd-devel

 

• Nginx添加http_image_filter_module模块

先查看旧版本Nginx的configure参数

 /usr/local/nginx/sbin/nginx -V

 

configure时添加http_image_filter_module模块

/configure --prefix=/usr/local/nginx --user=nginx 
--group=nginx --with-http_secure_link_module 
--with-http_stub_status_module  
--with-stream_ssl_preread_module  
--with-http_ssl_module  
--with-http_image_filter_module 

编译安装nginx

make 
cp ./objs/nginx /usr/local/nginx/sbin/

0x02：语法说明

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

默认值:    —

上下文:    location

设置图像变换的操作：

off : 在所在location关闭模块处理。

test :确保应答是JPEG，GIF或PNG格式的图像。否则错误 415 (Unsupported Media Type) 将被返回。

size: 以json格式返回图像信息。例如：

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

如果有错误发生，将会返回如下：

{}

rotate 90|180|270 : 将图像逆时针旋转指定角度。参数的值可以包含变量。可以单独使用，或与 resize 和 crop 变换同时使用.

resize width height: 按比例缩小图像至指定大小。如果想只指定其中一维，另一维可以指定为：“-”。如果有错误发生，服务器会返回 415 (Unsupported Media Type). 参数的值可以包含变量。当与 rotate 参数同时使用时, 旋转发生在缩放 之后。

crop width height : 按比例以图像的最短边为准对图像大小进行缩小，然后裁剪另一边多出来的部分。如果想只指定其中一维，另一维可以指定为：“-”。如果有错误发生，服务器会返回 415 (Unsupported Media Type). 参数的值可以包含变量。当与 rotate 参数同时使用时, 旋转发生在裁剪 之前。

• image_filter_buffer

语法:    image_filter_buffer size;

默认值:    image_filter_buffer 1M;

上下文:    http, server, location

设置用来读图像的缓冲区的最大值。若图像超过这个大小，服务器会返回 415 (Unsupported Media Type).

• 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

定义当对PNG，或者GIF图像进行颜色变换时是否需要保留透明度。损失透明度有可能可以获得更高的图像质量。PNG图像中的alpha通道的透明度默认会一直被保留。

image_filter off;  
#关闭模块  

image_filter test;  
#确保图片是jpeg gif png否则返415错误  

image_filter size;  
#输出有关图像的json格式：如下显示{ "img" : { "width": 100, "height": 100, "type": "gif" } } 出错显示：{}  

image_filter rotate 90|180|270;  
#旋转指定度数的图像，参数可以包括变量，单独或一起与resize crop一起使用。  

image_filter resize width height;  
#按比例减少图像到指定大小，如果减少一个可以另一个用"-"来表示,出错415，参数值可包含变量，可以与rotate一起使用，则两个一起生效。  

image_filter crop width height;  
#按比例减少图像比较大的侧面积和另一侧多余的裁剪边缘，其它和rotate一样。没太理解  

image_filter_buffer 10M;  
#设置读取图像缓冲的最大大小，超过则415错误。  

image_filter_interlace on;  
#如果启用，最终的图像将被交错。对于JPEG，最终的图像将在“渐进式JPEG”格式。  

image_filter_jpeg_quality 95;  
#设置变换的JPEG图像的期望质量。可接受的值是从1到100的范围内。较小的值通常意味着既降低图像质量，减少传输数据，推荐的最大值为95。参数值可以包含变量。  

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

image_filter_transparency on;  
#定义是否应该透明转换的GIF图像或PNG图像与调色板中指定的颜色时，可以保留。透明度的损失将导致更好的图像质量。在PNG的Alpha通道总是保留透明度。

0x03：实战http_image_filter_module

在Nginx配置文件nginx.conf添加如下配置

  location ~* .(jpg|gif|png)$ {
            image_filter test;
            root html;
            # 图片默认宽度
            set $width -;  
            # 图片默认高度
            set $height -;  
            if ($arg_width != "") {
                set $width $arg_width;
            }
            if ($arg_height != "") {
               set $height $arg_height;
            }
            # 设置图片宽高
            image_filter resize $width $height;  
            # 设置nginx读取图片最大buffer
            image_filter_buffer 10M;  
            # 是否开启图片隔行扫描            
            image_filter_interlace on;   
            error_page 404 = 400.html;
       }

配置完成后，在html目录新建image目录

 

访问可以查看结果

http://127.0.0.1/image/3.jpg?height=100
http://127.0.0.1/image/3.jpg?width=130
http://127.0.0.1/image/3.jpg?width=100&height=200

0x04：附录

几个可能有用的规则

• 匹配全站所有的结尾图片

 location ~* .(jpg|gif|png)$ {  
            image_filter resize 500 500;  
        }  

匹配某个目录所有图片

        location ~* /image/.*.(jpg|gif|png)$ {  
            image_filter resize 500 500;  
        }   

• 使用url指定大小

   location ~* (.*.(jpg|gif|png))!(.*)!(.*)$ {  
            set $width      $3;  
            set $height     $4;  
            rewrite "(.*.(jpg|gif|png))(.*)$" $1;  
        }  

        location ~* /image/.*.(jpg|gif|png)$ {  
            image_filter resize $width $height;  
        }   

http://127.0.0.1/image/girl.jpg!300!200

自动将原图缩放为300*200的尺寸