wudi / nlgm

NLGM (Nginx Lua GraphicsMagick) 提供一种实时处理图片的思路

NLGM (Nginx Lua GraphicsMagick)

Nginx 调用 Lua 脚本执行 GraphicsMagick 命令实时高效处理图片。

运行模式：Nginx 将当前请求任务交给Lua 脚本，脚本内获取当前请求 URI 对所需参数进行解析转换，拼接成 GraphicsMagick 命令，并执行。结果将缩略图生成到指定目录，rewrite 缩略图路径到 Nginx。

• 每个 URI 会进行 MD5 生成文件名，缓存图片，下次请求图片存在则直接返回
• 若源文件不存在则直接返回 404
• 注意配合 crontab 定时删除 thumbnail_dir 目录内一定时间内没有访问的文件
• 可通过HTTP响应头参数 T-Generate 查看当前是新生成还是 cache
• 可通过 v 参数进行运行命令 DEBUG

##Dependencies

GraphicsMagick

Download

http://sourceforge.net/projects/graphicsmagick/files/graphicsmagick/

tar zxvf  GraphicsMagick-1.3.23.tar.gz

cd GraphicsMagick-1.3.23

1）#yum 已经安装了 libjpeg libpng libjpeg-devel libpng-devel

./configure --prefix=/path/to/graphicsmagick 

2）#独立编译安装  libjpeg  libpng，  configure 需要指定 LDFLAGS  和 CPPFLAGS

./configure --prefix=/path/to/graphicsmagick 'LDFLAGS=-L/path/to/jpeg/lib' 'CPPFLAGS=-I/path/to/jpeg'  'LDFLAGS=-L/path/to/png/lib' 'CPPFLAGS=-I/path/to/png' 

make 

-- make 结果会显示 JPEG v1、PNG  的支持情况，确保支持 JPEG v1、PNG 

make install

Lua JIT

http://luajit.org/download.html

tar zxvf  LuaJIT-2.0.4.tar.gz

cd LuaJIT-2.0.4

make

make install PREFIX=/path/to/luajit-2.0/

export LUAJIT_LIB=/path/to/luajit-2.0/lib
export LUAJIT_INC=/path/to/luajit-2.0/include/luajit-2.0

Nginx && lua-nginx-module && ngx_devel_kit

http://nginx.org

https://github.com/openresty/lua-nginx-module

https://github.com/simpl/ngx_devel_kit

nginx compile module useage（Nginx打模块）

Recommended use the OpenResty project.

cd nginx-source

./configure --prefix=/opt/nginx \
--with-ld-opt="-Wl,-rpath,/path/to/luajit-2.0/lib" \
--add-module=/path/to/ngx_devel_kit \
--add-module=/path/to/lua-nginx-module

...

make && make install

Test Lua

server {
    listen  80;
    server_name  localhost;
    
    location /lua {
         default_type 'text/plain';
          
         content_by_lua ' ngx.say("Hello World!") ';
     }
}

http://domain.com/lua

See "Hello World!" in the page.

OK!

##Usage

Please read nlgm.conf .

Notes: Nginx add module U must stop the nginx and restart. (Not -s reload!!)

##Support Arguments

Arg	Mean
s	size
q	quality
m	crop mode
v	show GraphicsMagick command for debug

##TODO

• Support delimiter option
• Support more crop mode
• Auto create directory use ngx.thumbnail_dir
• Border radius
• More features from GraphicsMagick

---

eg: http://domain.com/t_s200x200/e3/3a/324jh3gh4jg32j4gj32g4.jpg