ngx_lua_API 指令详解，二ngx.re.match/find/gmatch/sub/gsub指令集合
1、先来个官方的ngx.re.match
location /ngx_re_match {
default_type text/html;
content_by_lua_block {
local m, err = ngx.re.match("/live/4001493201083.m3u8", "[0-9]+")
if m then
-- m[0] == "4001493201083"
ngx.say("makcj::",m[0])
else
if err then
ngx.log(ngx.ERR, "error: ", err)
return
end
ngx.say("match not found")
end
}
}分享：以上可以匹配nginx的uri里面的变量很方便。
2、ngx.re.match 指令
语法： captures，err = ngx.re.match（subject，regex，options？ctx？res_table？）
上下文： init_worker_by_lua *，set_by_lua *，rewrite_by_lua *，access_by_lua *，content_by_lua *，header_filter_by_lua *，body_filter_by_lua *，log_by_lua *，ngx.timer。*，balancer_by_lua *，ssl_certificate_by_lua *，ssl_session_fetch_by_lua *，ssl_session_store_by_lua *
subject使用regex可选的Perl兼容正则表达式匹配字符串options。
只有匹配的第一次出现被返回，或者nil如果没有匹配。在出现错误的情况下，如看到错误的正则表达式或超过PCRE堆栈限制，nil并返回描述错误的字符串。
当发现匹配时，captures返回一个Lua表，其中captures[0]保持整个子串匹配，并captures[1]保存第一个括号子模式的捕获，captures[2]第二个等等。
#demo1
local m, err = ngx.re.match("Tinywan, 1234", "([0-9])[0-9]+")
ngx.say("match_value m[0]:",m[0])
ngx.say("match_value m[1]:",m[1])输出：
match_value m[0]:1234 match_value m[1]:1
说明：很简单的，不必解释
#demo2
local m, err = ngx.re.match("hello, 1234", "([0-9])(?<remaining>[0-9]+)")
ngx.say("match_value m[0]:",m[0])
ngx.say("match_value m[1]:",m[1])
ngx.say("match_value m[2]:",m[2])
ngx.say("match_value m['remaining']:",m["remaining"])输出
match_value m[0]:1234 match_value m[1]:1 match_value m[2]:234 match_value m['remaining']:234
说明：命名捕获，并在与编号捕获的键值对相同的Lua表中返回
3、ngx.re.find
语法： from，to，err = ngx.re.find（subject，regex，options？ctx？，nth？）
上下文： init_worker_by_lua *，set_by_lua *，rewrite_by_lua *，access_by_lua *，content_by_lua *，header_filter_by_lua *，body_filter_by_lua *，log_by_lua *，ngx.timer。*，balancer_by_lua *，ssl_certificate_by_lua *，ssl_session_fetch_by_lua *，ssl_session_store_by_lua *
该方法与ngx.re.match方法基本类似，不同的地方在于ngx.re.find返回的是匹配的字串的起始位置索引和结束位置索引，如果没有匹配成功，那么将会返回两个nil，如果匹配出错，还会返回错误信息到err中。
#demo1
local s = "hello Tinywan, 123456"
local from, to, err = ngx.re.find(s, "([0-9]+)", "jo")
if from then
ngx.say("from: ", from)
ngx.say("to: ", to)
ngx.say("matched: ", string.sub(s, from, to))
else
if err then
ngx.say("error: ", err)
return
end
ngx.say("not matched!")
end输出：
from: 16 to: 21 matched: 123456
说明：字符串s的长度为21个字节，from：表示匹配成功的索引开始位置，to：则为结束位置，而配置的字符串长度为：to-from+1
！！！官方推荐理由：因为这个API函数不会创建新的Lua字符串或新的Lua表，它比ngx.re.match快得多。应尽可能使用。
自0.9.3发布以来，支持可选的第五个参数，nth以指定要返回哪个（子匹配）捕获的索引。当nth为0（默认为）时，返回整个匹配子字符串的索引; 何时nth为1，则返回第一个配对捕获的索引; 当nth为2时，则返回第二次匹配捕获，依此类推。当指定的子配对不匹配时，nil将返回两个值
local str = "hello Openresty, 1234878787"
local from, to = ngx.re.find(str, "([0-9])([0-9]+)", "jo", nil, 2)
if from then
ngx.say("matched 2nd submatch: ", string.sub(str, from, to))
end输出：matched 2nd submatch: 234878787
4、ngx.re.gmatch
语法： iterator，err = ngx.re.gmatch（subject，regex，options？）
上下文： init_worker_by_lua *，set_by_lua *，rewrite_by_lua *，access_by_lua *，content_by_lua *，header_filter_by_lua *，body_filter_by_lua *，log_by_lua *，ngx.timer。*，balancer_by_lua *，ssl_certificate_by_lua *，ssl_session_fetch_by_lua *，ssl_session_store_by_lua *
与ngx.re.match类似，但是返回一个Lua迭代器，以便让用户程序员<subject>使用PCRE 对string参数的所有匹配进行迭代regex。如果出现错误，就像看到形式不正常的正则表达式，nil并且将返回描述错误的字符串
#demo1
local iterator, err = ngx.re.gmatch("hello, world!", "([a-z]+)", "i")
if not iterator then
ngx.log(ngx.ERR, "error: ", err)
return
end
local m
m, err = iterator() -- m[0] == m[1] == "hello"
ngx.say(" 1 m[0] == ",m[0]," m[1] == ",m[1])
if err then
ngx.log(ngx.ERR, "error: ", err)
return
end
m, err = iterator() -- m[0] == m[1] == "world"
ngx.say(" 2 m[0] == ",m[0]," m[1] == ",m[1])
if err then
ngx.log(ngx.ERR, "error: ", err)
return
end
m, err = iterator() -- m == nil
if err then
ngx.log(ngx.ERR, "error: ", err)
return
end输出：
1 m[0] == hello m[1] == hello 2 m[0] == world m[1] == world
#demo2
local it, err = ngx.re.gmatch("hello, world!", "([a-z]+)", "i")
if not it then
ngx.log(ngx.ERR, "error: ", err)
return
end
while true do
local m, err = it()
if err then
ngx.log(ngx.ERR, "error: ", err)
return
end
if not m then
-- no match found (any more)
break
end
-- found a match
ngx.say(m[0])
ngx.say(m[1])
end输出：
hello hello world world
可选options参数与ngx.re.match方法完全相同的语义。
当前的实现需要仅在单个请求中使用返回的迭代器。也就是说，不应该将它分配给属于持久命名空间的变量，如Lua包。
该方法需要在Nginx中启用PCRE库。
5、ngx.re.sub
语法： newstr，n，err = ngx.re.sub（subject，regex，replace，options？）
上下文： init_worker_by_lua *，set_by_lua *，rewrite_by_lua *，access_by_lua *，content_by_lua *，header_filter_by_lua *，body_filter_by_lua *，log_by_lua *，ngx.timer。*，balancer_by_lua *，ssl_certificate_by_lua *，ssl_session_fetch_by_lua *，ssl_session_store_by_lua *
将带有字符串或函数参数regex的subject参数字符串的Perl兼容正则表达式的第一个匹配替换replace。可选options参数与ngx.re.match具有完全相同的含义。
此方法返回所生成的新字符串以及成功替换的数量。在出现故障的情况下，如正则表达式或<replace>字符串参数中的语法错误，它将返回nil一个描述该错误的字符串。
当replace是字符串时，它被视为用于字符串替换的特殊模板
#demo1
local newstr, n, err = ngx.re.sub("hello, 1234", "([0-9])[0-9]", "[$0][$1]")
if newstr then
-- newstr == "hello, [12][1]34"
-- n == 1
ngx.say("newstr == ",newstr)
else
ngx.log(ngx.ERR, "error: ", err)
return
end输出：
newstr == hello, [12][1]34 n == 1
说明：其中$0引用由模式匹配的整个子字符串，并$1引用第一个括号化的捕获子字符串
6、ngx.re.gsub
语法： newstr，n，err = ngx.re.gsub（subject，regex，replace，options？）
上下文： init_worker_by_lua *，set_by_lua *，rewrite_by_lua *，access_by_lua *，content_by_lua *，header_filter_by_lua *，body_filter_by_lua *，log_by_lua *，ngx.timer。*，balancer_by_lua *，ssl_certificate_by_lua *，ssl_session_fetch_by_lua *，ssl_session_store_by_lua *
就像ngx.re.sub一样，但是全局替换
#demo1
local newstr, n, err = ngx.re.gsub("hello, world", "([a-z])[a-z]+", "[$0,$1]", "i")
if newstr then
ngx.say("newstr == ",newstr)
ngx.say("n == ",n)
else
ngx.log(ngx.ERR, "error: ", err)
return输出：
newstr == [hello,h], [world,w] n == 2
说明：该方法需要在Nginx中启用PCRE库
#demo2
local func = function (m)
return "[" .. m[0] .. "," .. m[1] .. "]"
end
local newstr, n, err = ngx.re.gsub("hello, world", "([a-z])[a-z]+", func, "i")
ngx.say("newstr == ",newstr)
ngx.say("n == ",n)输出：
newstr == [hello,h], [world,w] n == 2
