【重要】Nginx模块Lua-Nginx-Module学习笔记（三）Nginx + Lua + Redis 已安装成功(非openresty 方式安装)

源码地址：https://github.com/Tinywan/Lua-Nginx-Redis

一、 目标

　　使用Redis做分布式缓存；使用lua API来访问redis缓存；使用nginx向客户端提供服务,ngx_lua将lua嵌入到nginx，让nginx执行lua脚本，高并发，非阻塞的处理各种请求。url请求nginx服务器，然后lua查询redis，返回json数据。

二、准备工作

　　系统环境：Ubuntu 14.0 (64位)

　　Redis服务安装：apt-get install redis-server

　　安装Git：apt-get install git

　　安装Lua：

# apt-get install lua5.1
# apt-get install liblua5.1-dev
# apt-get install liblua5.1-socket2
# apt-get install -y lua5.1 liblua5.1-0 liblua5.1-0-dev

补充：安装模块:stream-lua-nginx-module 出现的错误信息：

make[1]: *** [objs/addon/src/ngx_stream_lua_socket_tcp.o] Error 1

解决办法：

apt-get install lua-socket

三、下载库

 1、当前目录：/home/www 目录下面

 2、下载ngx_devel_kit (NDK（nginx development kit)模块，是一个拓展nginx服务器核心功能的模块，第三方模块开发可以基于它来快速实现。

wget https://github.com/simpl/ngx_devel_kit/archive/v0.3.0.tar.gz
tar -zxvf v0.3.0.tar.gz

3、lua-nginx-module 下载。可在 Nginx 中嵌入 Lua 语言，让 Nginx 可以支持 Lua 强大的语法。

wget https://github.com/openresty/lua-nginx-module/archive/v0.10.7.tar.gz
tar -zxvf v0.10.7.tar.gz

4、redis2-nginx-module 下载。是一个支持 Redis 2.0 协议的 Nginx upstream 模块，它可以让 Nginx 以非阻塞方式直接防问远方的 Redis 服务，同时支持 TCP 协议和 Unix Domain Socket 模式，并且可以启用强大的 Redis 连接池功能。

wget https://github.com/openresty/redis2-nginx-module/archive/v0.13.tar.gz
tar -zxvf v0.13.tar.gz

5、set-misc-nginx-module 下载。是标准的HttpRewriteModule指令的扩展，提供更多的功能，如URI转义与非转义、JSON引述，Hexadecimal、MD5、SHA1、Base32、Base64编码与解码、随机数等等

wget https://github.com/openresty/set-misc-nginx-module/archive/v0.31.tar.gz
tar -zxvf v0.31.tar.gz

6、echo-nginx-module 下载，是一个 Nginx 模块，提供直接在 Nginx 配置使用包括 "echo", "sleep", "time" 等指令。

wget https://github.com/openresty/echo-nginx-module/archive/v0.60.tar.gz
tar -zxvf v0.60.tar.gz

7、Nginx 下载

wget http://nginx.org/download/nginx-1.10.3.tar.gz
tar -zxvf nginx-1.10.3.tar.gz

四、安装

1、查看所有下载完的包

root@iZ236j3sofdZ:/home/www# ls
echo-nginx-module-0.60  lua-nginx-module-0.10.7  nginx-1.10.3  nginx-1.10.3.tar.gz  
ngx_devel_kit-0.3.0  redis2-nginx-module-0.13  redis-lua-2.0.4  set-misc-nginx-module-0.31

2、Nginx 配置文件检测

cd nginx-1.10.3/
 ./configure --prefix=/usr/local/nginx --with-debug --with-http_addition_module 
--with-http_perl_module --with-http_realip_module --with-http_secure_link_module 
--with-http_stub_status_module --with-http_ssl_module --with-http_sub_module 
--with-sha1=/usr/include/openssl --with-md5=/usr/include/openssl 
--add-module=../ngx_devel_kit-0.3.0 
--add-module=../echo-nginx-module-0.60 
--add-module=../lua-nginx-module-0.10.7 
--add-module=../redis2-nginx-module-0.13 
--add-module=../set-misc-nginx-module-0.31

【错误信息1】：

 ./configure: error: ngx_http_lua_module requires the Lua library

解决办法：

apt-get install lua5.1-0-dev

【错误信息3】：

./configure: error: the HTTP rewrite module requires the PCRE library.

解决办法：

apt-get install libreadline-dev libncurses5-dev libpcre3-dev 
libssl-dev perl make build-essential curl

【错误信息2】：

/usr/bin/ld: cannot find -lperl
collect2: error: ld returned 1 exit status

说明：/usr/bin/ld: cannot find -lxxx意思是编译过程找不到对应库文件。其中，-lxxx表示链接库文件 libxxx.so。了解更多cannot find -lxxx

解决办法：

apt-get install lperl-dev

五、编译

make
make install 

编译过程出现这个问题：

make[1]: Leaving directory `/home/www/nginx-1.10.3' 什么意思

解决办法：

到你的源码目录内，先make clean  然后./config ...

3、安装lua-redis-parser，lua-resty-redis是openresty（1.9.15.1）的一个组件，简单来说，它提供一个lua语言版的redis API，使用socket（lua sock）和redis通信。

//下载源码包：
git clone https://github.com/openresty/lua-resty-redis.git

移动该源码包到/usr/local/nginx/lua/ 这里去

mv lua-resty-redis /usr/local/nginx/lua/

4、使用Redis的提示错误

    [error] 7094#0: *1 lua entry thread aborted: runtime error: /usr/local/nginx/conf/lua/test_redis_basic.lua:11: module 'resty.redis' not found:
    no field package.preload['resty.redis']
    no file '/home/www/lua-redis-parser-0.12/resty/redis.lua'
    no file './resty/redis.lua'
    no file '/usr/local/share/lua/5.1/resty/redis.lua'
    no file '/usr/local/share/lua/5.1/resty/redis/init.lua'
    no file '/usr/local/lib/lua/5.1/resty/redis.lua'
    no file '/usr/local/lib/lua/5.1/resty/redis/init.lua'
    no file '/usr/share/lua/5.1/resty/redis.lua'
    no file '/usr/share/lua/5.1/resty/redis/init.lua'
    no file './resty/redis.so'
    no file '/usr/local/lib/lua/5.1/resty/redis.so'
    no file '/usr/lib/x86_64-linux-gnu/lua/5.1/resty/redis.so'
    no file '/usr/lib/lua/5.1/resty/redis.so'
    no file '/usr/local/lib/lua/5.1/loadall.so'
    no file './resty.so'
    no file '/usr/local/lib/lua/5.1/resty.so'
    no file '/usr/lib/x86_64-linux-gnu/lua/5.1/resty.so'
    no file '/usr/lib/lua/5.1/resty.so'
    no file '/usr/local/lib/lua/5.1/loadall.so'
stack traceback:

提示以上错误的原因是Lua的库文件没有加载合适导致的。只需要下载官方的源码包，按照以下应用即可

 lua_package_path "/usr/local/nginx/lua/lua-resty-redis/lib/?.lua;;";

六、测试

1、配置nginx.conf(以下是部分代码)

# nginx.conf
http {
　　.....
    lua_package_path "/usr/local/nginx/lua/lua-resty-redis/lib/?.lua;;";
    #gzip  on;
    server {
        listen       80;
        server_name  localhost;
        location / {
            root   html;
            index  index.html index.htm;
        }
        location /lua {
                echo "Hello Lua";
        }
        location /lua_test {
                content_by_lua '
                        ngx.say("Hello Lua! Tinywan")
                ';
        }
        #content_by_lua_block
        location =/content_by_lua_block {
                default_type 'text/plain';
                content_by_lua_block {
                        ngx.say('Hello : content_by_lua_block')
                }
        }
        location /{
                default_type 'text/html';
                lua_code_cache off;
                content_by_lua_file /usr/local/nginx/conf/lua/test_redis_basic.lua;
        }
   }
}

test_redis_basic.lua 添加以下内容：

local function close_redis(redis_instance)
    if not redis_instance then
        return
    end
    local ok,err = redis_instance:close();
    if not ok then
        ngx.say("close redis error : ",err);
    end
end

local redis = require("resty.redis");
--local redis = require "redis"
-- 创建一个redis对象实例。在失败，返回nil和描述错误的字符串的情况下
local redis_instance = redis:new();
--设置后续操作的超时（以毫秒为单位）保护，包括connect方法
redis_instance:set_timeout(1000)
--建立连接
local ip = '127.0.0.1'
local port = 6379
--尝试连接到redis服务器正在侦听的远程主机和端口
local ok,err = redis_instance:connect(ip,port)
if not ok then
    ngx.say("connect redis error : ",err)
    return close_redis(redis_instance);
end

--Redis身份验证
--local auth,err = redis_instance:auth("");
--if not auth then
--    ngx.say("failed to authenticate : ",err)
--end

--调用API进行处理
local resp,err = redis_instance:set("msg","hello world")
if not resp then
    ngx.say("set msg error : ",err)
    return close_redis(redis_instance)
end

--调用API获取数据  
local resp, err = redis_instance:get("msg")  
if not resp then  
    ngx.say("get msg error : ", err)  
    return close_redis(redis_instance)  
end 

--得到的数据为空处理  
if resp == ngx.null then  
    resp = 'this is not redis_data'  --比如默认值  
end  
ngx.say("msg : ", resp)  
  
close_redis(redis_instance)

我们通过curl 在shell脚本中测试以上配置文件

重启Nginx服务器：

root@iZ236j3sofdZ:/usr/local/nginx/conf# service nginx restart
 * Stopping Nginx Server...                      
 * Starting Nginx Server...         
 nginx: [alert] lua_code_cache is off; this will hurt performance in /usr/local/nginx/conf/nginx.conf:69

警告：这个alert是因为objstore.conf中把lua_code_cache为off；若设置为off，nginx不缓存lua脚本，每次改变lua代码，不必reload nginx即可生效；这便于开发和测试。但禁用缓存对性能有影响，故正式环境下一定记得设置为on；

location /lua

root@iZ236j3sofdZ:/usr/local/nginx/lua# curl "http://localhost/lua"
Hello Lua

location /lua_test

root@iZ236j3sofdZ:/usr/local/nginx/lua# curl "http://localhost/lua_test"
Hello Lua! Tinywan

location /content_by_lua_block

root@iZ236j3sofdZ:/usr/local/nginx/lua# curl "http://localhost/content_by_lua_block"
Hello : content_by_lua_block

location /lua_redis_basic

root@iZ236j3sofdZ:/usr/local/nginx/lua# curl "http://localhost/lua_redis_basic"
msg : hello worTinywan

 七、一些常见误区

1、redis2-nginx-module和lua-resty-redis

　　redis2-nginx-module是一个openresty（1.9.15.1）自带的模块。它能够把请求转发给upstream（redis2_pass）。注意它和lua-resty-redis不同，lua-resty-redis是一个lua语言版的redis API，使用socket（lua sock）和redis通信。而redis2-nginx-module是把请求转发给别的upstream。

2、以下错误解决办法

checking for LuaJIT library in /usr/bin/luajit/lib and  (specified by the LUAJIT_LIB and LUAJIT_INC env, with -ldl) ... not found
checking for LuaJIT library in /usr/bin/luajit/lib and  (specified by the LUAJIT_LIB and LUAJIT_INC env) ... not found
        ./configure: error: ngx_http_lua_module requires the Lua or LuaJIT library and LUAJIT_LIB is defined as
 /usr/bin/luajit/lib and LUAJIT_INC (path for lua.h) , but we cannot find LuaJIT there.

下载安装：LuaJIT-2.0.4 

更多版本下载地址：http://luajit.org/download.html

wget  http://luajit.org/download/LuaJIT-2.0.4.tar.gz
tar -zxvf  LuaJIT-2.0.4.tar.gz
make && sudo make install

告诉nginx的构建系统在哪里可以找到LuaJIT 2.0：

export LUAJIT_INC=/usr/local/include/luajit-2.0

 http://blog.csdn.net/qq_25551295/article/details/51744815