Nginx模板nginx_lua_module和echo-nginx-module安装过程

ngx_lua_module 是一个nginx http模块，它把 lua 解析器内嵌到 nginx，用来解析并执行lua 语言编写的网页后台脚本。

特性：
支持Windows和Linux平台。
支持高并发高性能。
HTML网页中内嵌LUA脚本代码，类似于PHP。
支持非阻塞的数据库操作，目前只支持MYSQL。
支持异步的文件IO操作。
支持非阻塞的SOCKET IO操作。

下面简要介绍下 ngx_lua_module 模块的安装。
方式一：使用大牛 ZhangYichun 提供的集成包快速安装。
非常简单，下载 ngx_openresty，该集成包中有：Nginx，Lua或Luajit，ngx_lua，以及一些有用的Nginx第三方模块。
安装步骤：
./configure --with-luajit
make
make install
安装完成！

方式二：Ngx_lua可以手动编译进Nginx。
首先，我的 Nginx 安装路径为：/usr/local/nginx。
我将尝试编译的两个模块：echo，lua。所需要的模块如下：
liujit             http://luajit.org
lua                http://www.lua.org
ngx_devel_kit      https://github.com/simpl/ngx_devel_kit
echo-nginx-module  https://github.com/agentzh/echo-nginx-module
lua-nginx-module   https://github.com/chaoslawful/lua-nginx-module

安装步骤：
1、Luajit2.0（推荐）或者 Lua5.1（Lua5.2暂不支持）
wget http://luajit.org/download/LuaJIT-2.0.0-beta9.tar.gz
tar zxvf LuaJIT-2.0.0-beta9.tar.gz
cd LuaJIT-2.0.0-beta9
make
sudo make install PREFIX=/usr/local/luajit
Note: to avoid overwriting a previous version,
the beta test releases only install the LuaJIT executable under the versioned name (i.e. luajit-2.0.0-beta10). 
You probably want to create a symlink for convenience, with a command like this:
sudo ln -sf luajit-2.0.0-beta9 /usr/local/bin/luajit (加上这句命令)

下面需要配置一下 luajit 或 lua 的环境变量(Nginx编译时需要)：
-- luajit --
# tell nginx's build system where to find LuaJIT:
export LUAJIT_LIB=/path/to/luajit/lib
export LUAJIT_INC=/path/to/luajit/include/luajit-2.0
-- lua --
# or tell where to find Lua if using Lua instead:
export LUA_LIB=/path/to/lua/lib
export LUA_INC=/path/to/lua/include
我的测试环境里，配置如下：
export LUAJIT_LIB=/usr/local/luajit/lib
export LUAJIT_INC=/usr/local/luajit/include/luajit-2.0

2、安装 ngx_devel_kit (NDK) 模块
cd /usr/local
git clone https://github.com/simpl/ngx_devel_kit.git
下载完成后，将在 /usr/local/ 目录下生成子目录 ngx_devel_kit。

3、安装 lua-nginx-module 模块
cd /usr/local
git clone https://github.com/chaoslawful/lua-nginx-module.git
下载完成后，将在 /usr/local/ 目录下生成子目录 lua-nginx-module。

4、重新编译Nginx，需要注意编译顺序！
./configure --prefix=/usr/local/nginx \
            --with-ld-opt="-Wl,-rpath,$LUAJIT_LIB" \
            --add-module=/usr/local/ngx_devel_kit \
            --add-module=/usr/local/echo-nginx-module \
            --add-module=/usr/local/lua-nginx-module
make -j2
make install
注释：重新编译 Nginx 二进制，Nginx 需要 quit 再启动。而普通配置更新则 reload 即可： kill -HUP `cat /path/nginx/logs/nginx.pid`
/usr/local/nginx/sbin/nginx -s reload
模块编译成功！重启Nginx服务器！
我在编译安装 Nginx 的第三方模块时，碰到一个错误：
/usr/local/nginx/sbin/ngxin -s reload
/usr/local/nginx/sbin/nginx: error while loading shared libraries: libluajit-5.1.so.2: cannot open shared object file: No such file or directory
百事不得其解，后来Google之，发现了解决办法。
在 Nginx 编译时，需要指定 RPATH，加入下面选项即可：
./configure --with-ld-opt="-Wl,-rpath,$LUAJIT_LIB"
或者
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH

5、测试Lua
在Nginx.conf 配置文件中，加入以下代码：
location /echo {
        default_type 'text/plain';
        echo 'hello echo';
}
location /lua {
        default_type 'text/plain';
    content_by_lua 'ngx.say("hello, lua")';
}
重启Nginx服务器： /usr/local/nginx/sbin/nginx -s reload

使用curl测试：
[root@localhost] curl http://localhost/echo
hello echo
[root@localhost] curl http://localhost/lua
hello lua

测试结果表明，两个模块都安装成功！关于ngx_lua模块的详细文档见下：
http://wiki.nginx.org/HttpLuaModule