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