環(huán)境: 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

這個(gè) Lua 表可以用來(lái)存儲(chǔ)基于請(qǐng)求的 Lua 環(huán)境數(shù)據(jù)，其生存周期與當(dāng)前請(qǐng)求相同 (類(lèi)似 Nginx 變量)。

參考下面例子，

 location /test {
  rewrite_by_lua_block {
   ngx.ctx.foo = 76
  }
  access_by_lua_block {
   ngx.ctx.foo = ngx.ctx.foo + 3
  }
  content_by_lua_block {
   ngx.say(ngx.ctx.foo)
  }
 }

訪問(wèn) GET /test 輸出

79

也就是說(shuō)，ngx.ctx.foo 條目跨越一個(gè)請(qǐng)求的 rewrite (重寫(xiě))，access (訪問(wèn))，和 content (內(nèi)容) 各處理階段保持一致。

每個(gè)請(qǐng)求，包括子請(qǐng)求，都有一份自己的 ngx.ctx 表。例如：

 location /sub {
  content_by_lua_block {
   ngx.say("sub pre: ", ngx.ctx.blah)
   ngx.ctx.blah = 32
   ngx.say("sub post: ", ngx.ctx.blah)
  }
 }

 location /main {
  content_by_lua_block {
   ngx.ctx.blah = 73
   ngx.say("main pre: ", ngx.ctx.blah)
   local res = ngx.location.capture("/sub")
   ngx.print(res.body)
   ngx.say("main post: ", ngx.ctx.blah)
  }
 }

訪問(wèn) GET /main 輸出

main pre: 73
sub pre: nil
sub post: 32
main post: 73

這里，在子請(qǐng)求中修改 ngx.ctx.blah 條目并不影響父請(qǐng)求中的同名條目，因?yàn)樗鼈兏髯跃S護(hù)不同版本的 ngx.ctx.blah。

內(nèi)部重定向?qū)⒋輾г颊?qǐng)求中的 ngx.ctx 數(shù)據(jù) (如果有)，新請(qǐng)求將會(huì)有一個(gè)空白的 ngx.ctx 表。例如，

 location /new {
  content_by_lua_block {
   ngx.say(ngx.ctx.foo)
  }
 }

 location /orig {
  content_by_lua_block {
   ngx.ctx.foo = "hello"
   ngx.exec("/new")
  }
 }

訪問(wèn) GET /orig 將輸出

nil

而不是原始的 "hello" 值。

任意數(shù)據(jù)值，包括 Lua 閉包與嵌套表，都可以被插入這個(gè)“魔法”表，也允許注冊(cè)自定義元方法。

也可以將 ngx.ctx 覆蓋為一個(gè)新 Lua 表，例如，

ngx.ctx = { foo = 32, bar = 54 }

當(dāng)用在 init_worker_by_lua* 環(huán)境中，這個(gè)表與當(dāng)前 Lua 句柄生命周期相同。

ngx.ctx 表查詢需要相對(duì)昂貴的元方法調(diào)用，這比通過(guò)用戶自己的函數(shù)參數(shù)直接傳遞基于請(qǐng)求的數(shù)據(jù)要慢得多。所以不要為了節(jié)約用戶函數(shù)參數(shù)而濫用此 API，因?yàn)樗赡軐?duì)性能有明顯影響。

而且由于元方法“魔法”，不要在 lua 模塊級(jí)別試圖使用 "local" 級(jí)別的 ngx.ctx ，例如 worker-level data sharing。下面示例是糟糕的：

-- mymodule.lua

local _M = {}

-- 下面一行的 ngx.ctx 是屬于單個(gè)請(qǐng)求的，但 ctx 變量是在 Lua 模塊級(jí)別

-- 并且屬于單個(gè) worker 的。

 local ctx = ngx.ctx

 function _M.main()
  ctx.foo = "bar"
 end

 return _M

應(yīng)使用下面方式替代：

 -- mymodule.lua
 local _M = {}

 function _M.main(ctx)
  ctx.foo = "bar"
 end

 return _M

就是說(shuō)，調(diào)用者對(duì) ctx 表調(diào)用應(yīng)通過(guò)函數(shù)傳參方式完成。

總結(jié)

以上就是這篇文章的全部?jī)?nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，如果有疑問(wèn)大家可以留言交流，謝謝大家對(duì)腳本之家的支持。

最新評(píng)論