使用Nginx中自带的模块配置缩略图功能的教程

时间:2022-06-01 20:27:11

http_image_filter_module是nginx提供的集成图片处理模块,支持nginx-0.7.54以后的版本,在网站访问量不是很高磁盘有限不想生成多余的图片文件的前提下可,就可以用它实时缩放图片,旋转图片,验证图片有效性以及获取图片宽高以及图片类型信息,由于是即时计算的结果,所以网站访问量大的话,不建议使用。
安装
安装还是很简单的,默认HttpImageFilterModule模块是不会编译进nginx的,所以要在configure时候指定

?
1
./configure arguments: --prefix=/usr/local/nginx --with-http_image_filter_module

PS: HttpImageFilterModule模块需要依赖gd-devel的支持,可以使用yum或apt-get方便地安装,如果未安装回报“/configure: error: the HTTP image filter module requires the GD library.”错误

?
1
yum install gd-devel
?
1
apt-get install libgd2-xpm libgd2-xpm-dev

make&&make install后就可以进行配置了,做最简单的配置,先让模块可以跑起来^^

?
1
2
3
4
5
6
location ~ /simg/.*\.jpg$ {
  #proxy_pass   http://10.11.11.11;
  #rewrite "/simg/(.*\.jpg)$" /img/$1 break ;
  image_filter  resize 100 100;
  error_page   415  = /empty;
}

 该模块主要有两个指令:
指令1:
语法: image_filter (test | size | resize width height | crop width height)
默认是: 无
可出现的上下文: location
该指令指定图像的转化形式:
(1)test - 测试回复是否是JPEG、GIF、或PNG图片(不支持BMP等其他格式),出错时返回415。
(2)size - 返回图片的JSON数据,比如:( "Img": ( "width": 100, "height": 100, "type": "gif"))
(3)resize - 根据设置按比例得减小图像,比如100*100的图片,而设置是50*25,减小后的图片为25*25。如果你只想设置一个维度,可以用“-”代替。出错时返回415。
(4)crop - 根据设置按比例得减小图像,然后裁剪成跟设置一样大小的图片。比如100*100的图片,而设置是50*25,减小后的图片为50*50,Nginx会选取中间高度25的像素,形成50*25的图片,所以图片会有缺失。如果你只想设置一个维度,可以用“-”代替。出错时返回415。
指令2:
语法: image_filter_buffer size
默认值: image_filter_buffer 1M
可出现的位置: http, server, location
该指令设置单图片缓存的最大值,如果过滤的图片大小超过缓存大小,会报错返回415。

用法
现在开始是重点:
有了如上认识再配合locaiont、if、image_filter 就可以让nginx动态生成缩略图了。
假设你的图片位于/img目录下
访问缩略图方式

?
1
http://www.xxx.cn/img/9GUMJR7200AJ0003_90x90.jpg

访问原图方式

?
1
2
3
4
http://www.xxx.cn/img/9GUMJR7200AJ0003_90x0.jpg
http://www.xxx.cn/img/9GUMJR7200AJ0003_0x50.jpg
http://www.xxx.cn/img/9GUMJR7200AJ0003_0x0.jpg
http://www.xxx.cn/img/9GUMJR7200AJ0003.jpg

添加如下配置到server上下文即可
       

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
location ~* /img/(.+)_(d+)x(d+).(jpg|gif|png)$ {     
     set $h $2;
     set $w $3;
     if ($h = "0") {
       rewrite /img/(.+)_(d+)x(d+).(jpg|gif|png)$ /img/$1.$4 last;
     }
     if ($w = "0") {
       rewrite /img/(.+)_(d+)x(d+).(jpg|gif|png)$ /img/$1.$4 last;
     }
 
     #根据给定的长宽生成缩略图
     image_filter resize $h $w;
     #原图最大2M,要裁剪的图片超过2M返回415错误,需要调节参数image_filter_buffer
     image_filter_buffer 2M;            
     
     #error_page 415       /img/notfound.jpg;
     try_files /img/$1.$4 /img/notfound.jpg;
   }
 
   location ~* /img {
     
   }
 
   location ~* /img/(.+)_(d+)x(d+).(jpg|gif|png)$ {     
     set $h $2;
     set $w $3;
     if ($h = "0") {
       rewrite /img/(.+)_(d+)x(d+).(jpg|gif|png)$ /img/$1.$4 last;
     }
     if ($w = "0") {
       rewrite /img/(.+)_(d+)x(d+).(jpg|gif|png)$ /img/$1.$4 last;
     }
 
     #根据给定的长宽生成缩略图
     image_filter resize $h $w;
     #原图最大2M,要裁剪的图片超过2M返回415错误,需要调节参数image_filter_buffer
     image_filter_buffer 2M;            
     
     #error_page 415       /img/notfound.jpg;
     try_files /img/$1.$4 /img/notfound.jpg;
   }
 
   location ~* /img {
     
   }