openresty ngx.ctx表

在 OpenResty 的體系中,可以通過共享記憶體的方式完成不同工作程序的資料共享,可以通過
 Lua 子產品方式完成單個程序内不同請求的資料共享。如何完成單個請求内不同階段的資料共
 享呢?最典型的例子,估計就是在 log 階段記錄一些請求的特殊變量。
 ngx.ctx 表就是為了解決這類問題而設計的。參考下面例子:
 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)
 }
 }
 首先 ngx.ctx 是一個表,是以我們可以對他添加、修改。它用來存儲基于請求的 Lua 環境數
 據,其生存周期與目前請求相同 (類似 Nginx 變量)。它有一個最重要的特性:單個請求内的
 rewrite (重寫),access (通路),和 content (内容) 等各處理階段是保持一緻的。
 額外注意,每個請求,包括子請求,都有一份自己的 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)
 }
 }
 通路 GET /main 輸出
 218不同階段共享變量
 main pre: 73
 sub pre: nil
 sub post: 32
 main post: 73
 任意資料值,包括 Lua 閉包與嵌套表,都可以被插入這個“魔法”表,也允許注冊自定義元方
 法。
 也可以将 ngx.ctx 覆寫為一個新 Lua 表,例如,
 ngx.ctx = { foo = 32, bar = 54 }
 ngx.ctx
 表查詢需要相對昂貴的元方法調用,這比通過使用者自己的函數參數直接傳遞基于請
 求的資料要慢得多。是以不要為了節約使用者函數參數而濫用此 API,因為它可能對性能有明顯
 影響。
 由于 ngx.ctx 儲存的是指定請求資源,是以這個變量是不能直接共享給其他請求使用的。