ngx_image_thumb是nginx顶用来生成缩略图的模块,保留缩略图的要领许多,本nginx模块主要成果是对请求的图片举办缩略/水印处理惩罚,支持文字水印和图片水印。支持自界说字体,文字巨细,水印透明度,水印位置,判定原图是否是否大于指定尺寸才处理惩罚等等。
1. 编译要领
编译前请确认您的系统已经安装了libcurl-dev libgd2-dev libpcre-dev 依赖库
1.1 Debian / Ubuntu 系统举例
# 假如你没有安装GCC相关情况才需要执行
$ sudo apt-get install build-essential m4 autoconf automake make
$ sudo apt-get install libgd2-noxpm-dev libcurl4-openssl-dev libpcre3-dev
1.2 CentOS /RedHat / Fedora
# 请确保已经安装了gcc automake autoconf m4
$ sudo yum install gd-devel pcre-devel libcurl-devel
1.3 FreeBSD / NetBSD / OpenBSD
# 不多说了,本身用port 把libcurl-dev libgd2-dev libpcre-dev 装上吧
# 编译前请确保已经安装gcc automake autoconf m4
1.4 Windows
# 也支持的,不外要修改的代码太多了,包罗Nginx自己,用VC++来编译
# 嫌贫苦可以用cygwin来编译。照旧不发起你这么做了,用Unix/Linux操纵系统吧。
2. nginx / tengine 安装
选Nginx照旧Tengine,您本身看,两者选其一
2.1 下载Tengine
# wget http://tengine.taobao.org/download/tengine-1.4.5.tar.gz
# tar -zxvf tengine-1.4.5.tar.gz
# cd tengine-1.4.5
2.2 下载Nginx
# wget http://nginx.org/download/nginx-1.4.0.tar.gz
# tar -zxvf nginx-1.4.0.tar.gz
# cd nginx-1.4.0
2.3 安装模块
# wget https://github.com/3078825/nginx-image/archive/master.zip
# unzip master.zip
# ./configure --add-module=./nginx-image-master
# make
# make install
3. 设置
location / {
root html;
#添加以下设置
image on;
image_output on;
}
4. 参数
image on/off 是否开启缩略图成果,默认封锁 image_backend on/off 是否开启镜像处事,当开启该成果时,请求目次不存在的图片(判定原图),将自动从镜像处事器地点下载原图 image_backend_server 镜像处事器地点 image_output on/off 是否不生成图片而直接处理惩罚后输出 默认off image_jpeg_quality 75 生成JPEG图片的质量 默认值75 image_water on/off 是否开启水印成果 image_water_type 0/1 水印范例 0:图片水印 1:文字水印 image_water_min 300 300 图片宽度 300 高度 300 的环境才添加水印 image_water_pos 0-9 水印位置 默认值9 0为随机位置,1为顶端居左,2为顶端居中,3为顶端居右,4为中部居左,5为中部居中,6为中部居右,7为底端居左,8为底端居中,9为底端居右 image_water_file 水印文件(jpg/png/gif),绝对路径可能相对路径的水印图片 image_water_transparent 水印透明度,默认20 image_water_text 水印文字 "Power By Vampire" image_water_font_size 水印巨细 默认 5 image_water_font 文字水印字体文件路径 image_water_color 水印文字颜色,默认 #000000
4.1挪用说明
这里假设你的nginx 会见解点为 http://127.0.0.1/
并在nginx网站根目次存在一个 test.jpg 的图片
通过会见
http://127.0.0.1/test.jpg!c300x200.jpg 将会 生成/输出 test.jpg 300x200 的缩略图
个中 c 是生成图片缩略图的参数, 300 是生成缩略图的 宽度 200 是生成缩略图的 高度
一共可以生成四种差异范例的缩略图。
支持 jpeg / png / gif (Gif生成后酿成静态图片)
C 参数按请求宽高比例从图片高度 10% 处开始截取图片,然后缩放/放大到指定尺寸( 图片缩略图巨细便是请求的宽高 )
M 参数按请求宽高比例居中截图图片,然后缩放/放大到指定尺寸( 图片缩略图巨细便是请求的宽高 )
T 参数按请求宽高比例按比例缩放/放大到指定尺寸( 图片缩略图巨细大概小于请求的宽高 )
W 参数按请求宽高比例缩放/放大到指定尺寸,空缺处填充白色配景颜色( 图片缩略图巨细便是请求的宽高 )
5. 挪用举例
http://127.0.0.1/test.jpg!c300x300.jpg
http://127.0.0.1/test.jpg!t300x300.jpg
http://127.0.0.1/test.jpg!m300x300.jpg
http://127.0.0.1/test.jpg!w300x300.jpg
http://127.0.0.1/test.c300x300.jpg
http://127.0.0.1/test.t300x300.jpg
http://127.0.0.1/test.m300x300.jpg
http://127.0.0.1/test.w300x300.jpg