ngx_lua_API 指令详解（一）ngx.timer.at 指令，

文章由LinuxBoy分享于2019-10-08 05:10:41热评（675）

ngx_lua_API 指令详解（一）ngx.timer.at 指令，

语法： ok，err = ngx.timer.at（delay，callback，user_arg1，user_arg2 ...）

上下文： 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 *

描述：

　　创建一个带有用户回调函数的Nginx定时器以及可选的用户参数。

第一个参数

　　delay指定定时器的延迟（以秒为单位）。可以指定小数秒0.001，这意味着1毫秒。0也可以指定延迟，在这种情况下，当当前处理程序产生执行时，定时器将立即过期。

第二个参数

　　callback可以是任何Lua函数，后面将在后面的“light thread”中调用延迟指定。用户回调将自动Nginx的芯与参数调用premature， user_arg1，user_arg2，和等等，其中，所述premature 参数采用一个布尔值指示是否它是一个过早的计时器期满或没有，和user_arg1，user_arg2和等等，是那些（额外的）用户调用ngx.timer.at 作为剩余参数时指定的参数。

　　当Nginx工作进程正在尝试关闭时，会发生提前定时器到期，如在Nginx配置中由HUP信号触发的重新加载或Nginx服务器关闭。当Nginx工作器试图关闭时，不能再调用ngx.timer.at创建具有非零延迟的新定时器，在这种情况下ngx.timer.at将返回nil，还有一个描述错误的字符串，即“进程退出”。

　　从v0.9.3发行版开始，即使Nginx工作进程开始关闭，也允许创建零延迟定时器。

　　当定时器到期时，定时器回调中的用户Lua代码正在从创建定时器的原始请求完全分离的“轻线程”中运行。因此，与创建它们的请求（如子仓）具有相同生命周期的对象不能在原始请求和定时器用户回调函数之间共享。

一、只执行一次

nginx.conf

   location /ngx_timer_at {
        default_type 'text/html';
        lua_code_cache off;
        content_by_lua_file /home/tinywan/Openresty_Protect/First_Protect/lua/get_timer_at.lua;
    }

get_timer_at.lua 文件

local delay = 5
local handler
handler = function (premature,param)
    -- do some routine job in Lua just like a cron job
    if premature then
        return
    end

    ngx.log(ngx.ERR, "param is : ", param)
end

local ok, err = ngx.timer.at(delay, handler,"Hello Tinywan")

执行请求后：curl http://127.0.0.1/ngx_timer_at 执行 5 s 后打印以下内容在日志文件中

    tail -f error.log 
    2017/05/04 23:24:38 [error] 95933#0: *433016 [lua] get_timer_at.lua:9: param is : Hello Tinywan, context: ngx.timer, client: 127.0.0.1, server: 0.0.0.0:80

二、不停的循环，和while 一样的结果

local delay = 5
local handler
handler = function (premature,param)
    -- do some routine job in Lua just like a cron job
    if premature then
        return
    end

    ngx.log(ngx.ERR, "param is : ", param)

   ngx.timer.at(delay, handler,"again run... Tinywan")
end

local ok, err = ngx.timer.at(delay, handler,"Hello Tinywan")

执行请求后：curl http://127.0.0.1/ngx_timer_at 执行 5 s 后打印以下内容在日志文件中

2017/05/04 23:34:53 [error] 96020#0: *437080 [lua] get_timer_at.lua:9: param is : Hello Tinywan, context: ngx.timer, client: 127.0.0.1, server: 0.0.0.0:80
2017/05/04 23:34:58 [error] 96020#0: *437123 [lua] get_timer_at.lua:9: param is : again run... Tinywan, context: ngx.timer, client: 127.0.0.1, server: 0.0.0.0:80
2017/05/04 23:35:03 [error] 96020#0: *437152 [lua] get_timer_at.lua:9: param is : again run... Tinywan, context: ngx.timer, client: 127.0.0.1, server: 0.0.0.0:80
2017/05/04 23:35:08 [error] 96020#0: *437195 [lua] get_timer_at.lua:9: param is : again run... Tinywan, context: ngx.timer, client: 127.0.0.1, server: 0.0.0.0:80
2017/05/04 23:35:13 [error] 96020#0: *437224 [lua] get_timer_at.lua:9: param is : again run... Tinywan, context: ngx.timer, client: 127.0.0.1, server: 0.0.0.0:80

syntax: headers = ngx.req.get_headers(max_headers?, raw?)

context: set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*

Returns a Lua table holding all the current request headers.

 local h = ngx.req.get_headers()
 for k, v in pairs(h) do
     ...
 end

json 和 lua table 转换的细节

推荐文章：

ngx_lua_API 指令详解（一）ngx.timer.at 指令，