Ngx_Lua使用分享

时间  2019-11-06
标签 ngx lua 使用 分享 栏目 Lua 繁體版
原文   原文链接
2017年04月22日 20:05:21
阅读数：430

1. Nginx_Lua

1.1. 介绍

ngx_lua – 把lua语言嵌入nginx中,使其支持lua来快速开发基于nginx下的业务逻辑php

该模块不在nginx源码包中，需自行下载编译安装。使用lua 5.1（目前不支持lua 5.2） 或 luajit 2.0 。html

添加lua支持后，开发复杂的模块，周期快，依然是100%异步非阻塞。python

ngx_lua 哪些人在用:mysql

淘宝、腾讯财经、网易财经、360、去哪儿网等nginx

CloudFlare, CNN, Wingify, Reblaze, Turner, Broadcasting Systemgit

该项目主要开发者：github

chaoslawful Taobao, Alibaba Grp.sql

agentzh CloudFlareapi

https://github.com/chaoslawful/lua-nginx-module缓存

1.2. 安装

1.2.1. 安装JIT平台

JIT

一般，程序有两种运行方式：静态编译与动态直译。

静态编译的程序在执行前所有被翻译为机器码，而动态直译执行的则是一句一句边运行边翻译。

即时编译(Just-In-Time Compiler)则混合了这两者，一句一句编译源代码，可是会将翻译过的代码缓存起来以下降性能损耗。

JAVA、.NET 实现都使用即时编译以提供高速的代码执行。

注意：

在nginx.conf中添加"lua_code_cache on/off"，来开启是否将代码缓存，因此每次变动"*.lua"文件时，必须reload nginx才可生效。

仅针对"set_by_lua_file, content_by_lua_file, rewrite_by_lua_file, and access_by_lua_file"有效, 由于其余为写在配置文件

中，更改代码也必须reload nginx。在生产环境下，不能禁用cache。同时在lua代码中使用"dofile" 或 "loadfie" 来加载外部lua脚步

将不会对它进行缓存，应该使用"require"来代替。禁用cache，当且仅当在调式代码下。

demo 1

LuaJIT

是一个利用JIT编译技术把Lua脚本直接编译成机器码由CPU运行

版本：2.0 与 2.1

当前稳定版本为 2.0。
2.1为版本与ngx_lua将有较大性能提高，主要是CloudFlare公司对luajit的捐赠。

FFI库，是LuaJIT中最重要的一个扩展库。
1. 它容许从纯Lua代码调用外部C函数，使用C数据结构;
2. 就不用再像Lua标准math库同样，编写Lua扩展库;
3. 把开发者从开发Lua扩展C库（语言/功能绑定库）的繁重工做中释放出来;

demo 2

下载编译

wget -c http://luajit.org/download/LuaJIT-2.0.2.tar.gz
tar xzvf LuaJIT-2.0.2.tar.gz
cd LuaJIT-2.0.2
make install PREFIX=/usr/local/luajit
echo "/usr/local/luajit/lib" > /etc/ld.so.conf.d/usr_local_luajit_lib.conf
ldconfig
#注意环境变量!
export LUAJIT_LIB=/usr/local/luajit/lib
export LUAJIT_INC=/usr/local/luajit/include/luajit-2.0

1.2.2. NDK与Lua_module

NDK(Nginx Development Kit)模块是一个拓展Nginx服务器核心功能的模块

第三方模块开发能够基于它来快速实现

NDK提供函数和宏处理一些基本任务，减轻第三方模块开发的代码量。

wget -c https://github.com/simpl/ngx_devel_kit/archive/v0.2.18.tar.gz
wget -c https://github.com/chaoslawful/lua-nginx-module/archive/v0.8.6.tar.gz
tar xzvf v0.2.18
tar xzvf v0.8.6

1.2.3. 编译安装Nginx

wget -c http://nginx.org/download/nginx-1.4.2.tar.gz
tar xzvf nginx-1.4.2.tar.gz
cd nginx-1.4.2
./configure --add-module=../ngx_devel_kit-0.2.18/ --add-module=../lua-nginx-module-0.8.6/
make
make install

1.3. 嵌入Lua后

1.3.1. 检测版本

本身编译官方的 nginx 源码包，只需事前指定 LUAJIT_INC 和 LUAJIT_LIB 这两个环境变量。

验证你的 LuaJIT 是否生效，能够经过下面这个接口： 

location = /lua-version { 
	content_by_lua ' 
        	if jit then 
                	ngx.say(jit.version) 
            	else 
                	ngx.say(_VERSION) 
        	end 
        '; 
} 

demo 3

若是使用的是标准 Lua，访问 /lua-version 应当返回响应体 Lua 5.1
若是是 LuaJIT 则应当返回相似 LuaJIT 2.0.2 这样的输出。 
不要使用标准lua，应当使用luajit, 后者的效率比前者高多了。

也能够直接用 ldd 命令验证是否链了 libluajit-5.1 这样的 .so 文件，例如： 
[root@limq5 sbin]# ldd  nginx | grep lua
	libluajit-5.1.so.2 => /usr/local/luajit/lib/libluajit-5.1.so.2 (0x00007f48e408b000)
[root@limq5 sbin]#

1.3.2. Hello,World

在nginx.conf中的service添加一个location。

location = /test {
       content_by_lua '
           ngx.say("Hello World")
	   ngx.log(ngx.ERR, "err err err")
       ';
}

demo 4

用户访问 http://localhost/test 将会打印出“Hello World”内容。

ngx.say 是 lua 显露給模块的接口。

相似的有 ngx.log(ngx.DEBUG, “”),能够在error.log输出调试信息。

另外也能够调用外部脚本，如同咱们写php、jsp应用时,业务脚本单独组织在.php或.jsp文件中同样

location = /test2 {
       content_by_lua_file conf/lua/hello.lua;
}

文件hello.lua内容以下：

ngx.say("Hello World")

这里的脚本能够任意复杂,也可使用Lua 本身的库

lua可用模块列表：

http://luarocks.org/repositories/rocks/

安装相似yum，它也有一个仓库:

luarocks install luafilesystem

运行上面命令后，会编译一个 “lfs.so”, 文件，拷贝文件到nginx定义的LUA_PATH中，而后引用

该库，就可调用其中函数。

LUA_PATH:

lua_package_path ‘/opt/17173/nginx-ds/conf/lua/?.lua;;’

lua_package_cpath ‘/opt/17173/nginx-ds/conf/lua/lib/?.so;/usr/local/lib/?.?;;’;

其中”;;”表明原先查找范围。

demo 5

1.3.3. 同步形式，异步执行

咱们假定,同时要访问多个数据源，并且,查询是没有依赖关系,那咱们就能够同时发出请求

这样我总的延时, 是我全部请求中最慢的一个所用时间,而不是原先的全部请求用时的叠加

location = /api {
       content_by_lua '
           local res1, res2, res3 =
               ngx.location.capture_multi{
                   {"/memc"}, {"/mysql"}, {"/postgres"}
               }
           ngx.say(res1.body, res2.body, res3.body)
       ';
}

demo 6
ngx.location.capture 没法跨server进行处理, 只能在同一个server下的不一样location。

1.4. Nginx与Lua执行顺序

1.4.1. Nginx顺序

Nginx 处理每个用户请求时，都是按照若干个不一样阶段（phase）依次处理的，而不是根据配置文件上的顺序。

Nginx 处理请求的过程一共划分为 11 个阶段，按照执行顺序依次是

post-read、server-rewrite、find-config、rewrite、post-rewrite、 preaccess、access、post-access、try-files、content、log.

post-read:
读取请求内容阶段
Nginx读取并解析完请求头以后就当即开始运行
例如模块 ngx_realip 就在 post-read 阶段注册了处理程序，它的功能是迫使 Nginx 认为当前请求的来源地址是指定的某一个请求头的值。
server-rewrite
Server请求地址重写阶段
当 ngx_rewrite 模块的set配置指令直接书写在 server 配置块中时，基本上都是运行在 server-rewrite 阶段
find-config
配置查找阶段
这个阶段并不支持 Nginx 模块注册处理程序，而是由 Nginx 核心来完成当前请求与 location 配置块之间的配对工做。
rewrite
Location请求地址重写阶段
当 ngx_rewrite 模块的指令用于 location 块中时，即是运行在这个 rewrite 阶段。
另外，ngx_set_misc(设置md五、encode_base64等) 模块的指令，还有 ngx_lua 模块的 set_by_lua 指令和 rewrite_by_lua 指令也在此阶段。
post-rewrite
请求地址重写提交阶段
由 Nginx 核心完成 rewrite 阶段所要求的“内部跳转”操做,若是 rewrite 阶段有此要求的话。
preaccess
访问权限检查准备阶段
标准模块 ngx_limit_req 和 ngx_limit_zone 就运行在此阶段，前者能够控制请求的访问频度，然后者能够限制访问的并发度。
access
访问权限检查阶段
标准模块 ngx_access、第三方模块 ngx_auth_request 以及第三方模块 ngx_lua 的 access_by_lua 指令就运行在这个阶段。
配置指令可能是执行访问控制性质的任务，好比检查用户的访问权限，检查用户的来源 IP 地址是否合法
post-access
访问权限检查提交阶段
主要用于配合 access 阶段实现标准 ngx_http_core 模块提供的配置指令 satisfy 的功能。
satisfy all(与关系)
satisfy any(或关系)
try-files
配置项try_files处理阶段
专门用于实现标准配置指令 try_files 的功能
若是前 N-1 个参数所对应的文件系统对象都不存在，try-files 阶段就会当即发起“内部跳转”到最后一个参数（即第 N 个参数）所指定的 URI.
content
内容产生阶段
Nginx 的 content 阶段是全部请求处理阶段中最为重要的一个，由于运行在这个阶段的配置指令通常都肩负着生成“内容”
并输出 HTTP 响应的使命。
log
日志模块处理阶段
记录日志

淘宝有开放一个nginx开发手册，里面包含不少有用的资料

http://tengine.taobao.org/book/

做者的google论坛：

https://groups.google.com/forum/#!forum/openresty

1.4.2. Lua顺序

Nginx下Lua处理阶段与使用范围：

init_by_lua            http
set_by_lua             server, server if, location, location if
rewrite_by_lua         http, server, location, location if
access_by_lua          http, server, location, location if
content_by_lua         location, location if
header_filter_by_lua   http, server, location, location if
body_filter_by_lua     http, server, location, location if
log_by_lua             http, server, location, location if
timer
init_by_lua:
在nginx从新加载配置文件时，运行里面lua脚本，经常使用于全局变量的申请。
例如lua_shared_dict共享内存的申请，只有当nginx重起后，共享内存数据才清空，这经常使用于统计。

set_by_lua:
设置一个变量，经常使用与计算一个逻辑，而后返回结果
该阶段不能运行Output API、Control API、Subrequest API、Cosocket API

rewrite_by_lua:
在access阶段前运行，主要用于rewrite

access_by_lua:
主要用于访问控制，能收集到大部分变量，相似status须要在log阶段才有。
这条指令运行于nginx access阶段的末尾，所以老是在 allow 和 deny 这样的指令以后运行，虽然它们同属 access 阶段。

content_by_lua:
阶段是全部请求处理阶段中最为重要的一个，运行在这个阶段的配置指令通常都肩负着生成内容（content）并输出HTTP响应。

header_filter_by_lua:
通常只用于设置Cookie和Headers等
该阶段不能运行Output API、Control API、Subrequest API、Cosocket API

body_filter_by_lua:
通常会在一次请求中被调用屡次, 由于这是实现基于 HTTP 1.1 chunked 编码的所谓“流式输出”的。
该阶段不能运行Output API、Control API、Subrequest API、Cosocket API

log_by_lua:
该阶段老是运行在请求结束的时候，用于请求的后续操做，如在共享内存中进行统计数据,若是要高精确的数据统计，应该使用body_filter_by_lua。
该阶段不能运行Output API、Control API、Subrequest API、Cosocket API

timer:

可参考官方文档：

http://wiki.nginx.org/HttpLuaModule

2. Lua基本语法

2.1. 关键字

and	break	do	else	elseif	
end	false	for	function	if	
in	local	nil	not	or	
repeat	return	then	true	until	while

2.2. 运算

2.2.1. 数字运算

支持 +, -, *, /,^  好比2^3 结果为8, 2^4结果为16。
链接两个字符串，用".."运处符, php为".", JAVA、C#为"+"

2.2.2. 赋值运算

a,b,c,d=1,2,3,4   -- 多变量一块儿赋值
a,b=b,a  --交换变量功能
在默认状况下，变量老是认为是全局的。假如须要定义局部变量，则在第一次赋值的时候，须要用local说明。好比：
local a,b,c = 1,2,3  -- a,b,c都是局部变量

2.2.3. 逻辑运算

and, or, not
在Lua中，只有false和nil才计算为false，其它任何数据都计算为true，0也是true
and 和 or的运算结果不是true和false，而是和它的两个操做数相关。

a and b：若是a为false，则返回a；a true 返回b
a or b：若是 a 为true，则返回a；a false 返回b
模拟C语言中的语句：x = a? b : c，在Lua中，能够写成：x = a and b or c。
最有用的语句是： x = x or v，它至关于：if not x then x = v end 。

2.3. 条件判断语句

2.3.1. if

if 条件 then 
      ... 
elseif 条件 then
      ... else ... 
end

2.3.2. repeat

repeat ... until 条件

2.3.3. while

while 条件 
do 
      ... 
end

2.3.4. for

for 变量=初值, 终点值, 步进 
do
      ... 
end
for 变量1, 变量2, ... 变量n in 表或枚举函数 
do 
       ... 
end

2.4. 经常使用结构

2.4.1. table

1. table 是 lua 中最重要的数据类型。
2. table 相似于 python 中的字典。
3. table 只能经过构造式来建立

;例1

Lua代码
tab = { a = 10, b = 20, c = 30, d = 40 }  
print(tab["a"])  

注释： 
1）table 中的每项要求是 key = value 的形式 
2）key 只能是字符串， 这里的 a, b, c, d 都是字符串，可是不能加上引号 
3）经过 key 来访问 table 的值，这时候， a 必须加上引号

;例2

tab = { 10, m = 20, 11, 12, 13 }  

print(tab[1])  = 10
print(tab[2])  = 11
print(tab[3])  = 12
print(tab[4])  = 13

获取表长度：
print(table.getn(tab))  -> 4
print(#tab)             -> 4

遍历表：
for k, v in pairs(tab) do
	print(k, ":", v)
end

1	:	10
2	:	11
3	:	12
4	:	13
m	:	20

注释：
1）省略key，会自动以1开始编号，并跳过设置过的key
2）获取表长度，只有当表使用1自动编号开始，能够获取

2.4.2. lua表空判断

在项目的脚本lua中常常有这样的需求

local a = {}
判断表a是否为空，有提供api table.maxn(a) 或 #a 获取表a长度，可是该状况只
针对key为数字且安装递增方式。

对于自定义key的状况下，获取表长度将会失败，可经过lua内置 next函数解决该问题。

2.5. 参考

lua官方手册        http://www.lua.org/manual/5.1/
lua中文翻译手册    http://www.codingnow.com/2000/download/lua_manual.html
转载：http://17173ops.com/2013/11/01/17173-ngx-lua-manual.shtml
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程