← 返回

在 OpenResty 中跨請求共享資料

章亦春釋出於 Dec 1, 2020 更新於 Dec 1, 2020

預計閱讀 4 分鐘

閱讀次數

本教程將逐步演示如何在 OpenResty 應用程式服務的不同 HTTP 請求中共享資料。

cd ~/
mkdir data-share
cd data-share/
mkdir conf logs lua
tree

我們首先準備測試應用程式的目錄樹。

在請求之間共享資料的簡單方法是使用一個名為 lua/my-module.lua 的自定義 Lua 模組。

我們進行以下編輯：

我們在這個模組的頂層增加一個全域性計數器變數。
然後我們總是在一個名為 main 的模組函式中遞增這個計數器。
並返回新的計數器值。

local _M = {}

local counter = 0

function _M.main()
    counter = counter + 1
    return counter
end

return _M

現在讓我們快速製作 nginx 配置檔案，conf/nginx.conf。

我們進行以下編輯：

在這裡，我們指定在哪裡尋找我們的 Lua 模組。
然後在本地 8080 埠上定義一個監聽伺服器。
而根位置下有 content_by_lua_block。
載入我們的 Lua 模組並呼叫它的 main 函式。
並將返回的計數器值作為響應體輸出。

worker_processes 1;

events {
    worker_connections 1024;
}

http {
    lua_package_path "$prefix/lua/?.lua;;";

    server {
        listen 8080;

        location / {
            default_type text/plain;
            content_by_lua_block {
                local mod = require "my-module"
                local cnt = mod.main()
                ngx.say("counter = ", cnt)
            }
        }
    }
}

我們再來檢查一下目錄樹。

tree .

看起來不錯。

在沒有 sudo 的情況下啟動這個 OpenResty 應用程式。

openresty -p $PWD/

在這裡，我們只啟用一個工作程序。

ps aux|grep nginx|grep -v tmp

使用 curl 向伺服器傳送 HTTP 請求。

curl 'http://127.0.0.1:8080/'

計數器的值是 1。

再來一次：

酷，現在是 2。

它只會不斷增長。

這個 counter Lua變數是共享的，因為它是 Lua 模組函式的 “up value”（upvalue）。

cat lua/my-module.lua

而 Lua 模組在全域性 LuaJIT 虛擬機器中被快取和共享。

resty -Ilua -e 'require "my-module" print(package.loaded["my-module"].main)'

看到了嗎？我們也可以直接訪問快取的 Lua 模組。

package.load全域性表儲存了所有載入的 Lua 模組。

resty -e 'for k, v in pairs(package.loaded) do print(k) end'

在這裡，大部分的模組都是那些標準的模組。

但是有一個限制。這些資料不能在不同的 nginx 工作程序之間共享。

這裡沒有問題，因為只配置了 1 個工作程序。

但通常我們會透過啟用多個工作程序來利用多個 CPU 核心。

worker_processes 4;

那麼每個工作程序都會有自己的計數器。

讓我們測試配置，然後重新載入伺服器。

openresty -p $PWD/ -t
kill -HUP `cat logs/nginx.pid`

現在我們應該有 4 個工作程序。

ps aux|grep nginx|grep -v tmp

所以這種 Lua 模組資料共享的方式主要是用於 Lua 級別的資料快取。

與 OpenResty 一起提供的 resty.lucache Lua 模組就是為這樣的場景設計的。

restydoc resty.lrucache

我們將在以後的教程中介紹這個模組。

如果我們想在所有工作程序中共享資料，我們應該使用 Lua 共享記憶體字典來代替。

restydoc -s lua_shared_dict
restydoc -s ngx.shared.DICT

我們將在另一個專門的教程中介紹這個話題。

今天我想介紹的就這麼多。祝程式設計愉快！如果你喜歡這個教程，請訂閱這個部落格網站和我們的 YouTube 頻道或 B 站頻道。謝謝！

立即申請 OpenResty XRay 試用

關於本文和關聯影片

本文和相關聯的影片都是完全由我們的 OpenResty Showman 產品從一個簡單的劇本檔案自動生成的。

關於作者

章亦春是開源 OpenResty^® 專案創始人兼 OpenResty Inc. 公司 CEO 和創始人。

章亦春（Github ID: agentzh），生於中國江蘇，現定居美國灣區。他是中國早期開源技術和文化的倡導者和領軍人物，曾供職於多家國際知名的高科技企業，如 Cloudflare、雅虎、阿里巴巴, 是 “邊緣計算“、”動態追蹤 “和 “機器程式設計 “的先驅，擁有超過 22 年的程式設計及 16 年的開源經驗。作為擁有超過 4000 萬全球域名使用者的開源專案的領導者。他基於其 OpenResty^® 開源專案打造的高科技企業 OpenResty Inc. 位於美國矽谷中心。其主打的兩個產品 OpenResty XRay（利用動態追蹤技術的非侵入式的故障剖析和排除工具）和 OpenResty Edge（最適合微服務和分散式流量的全能型閘道器軟體），廣受全球眾多上市及大型企業青睞。在 OpenResty 以外，章亦春為多個開源專案貢獻了累計超過百萬行程式碼，其中包括，Linux 核心、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl 等，並編寫過 60 多個開源軟體庫。