在本教程中，我們將演示如何使用 OpenResty 附帶的 resty 命令列工具。

cd ~
export PATH=/usr/local/openresty/bin:$PATH
which resty

一般都是這個路徑。

我們可以透過 -V 選項檢查其版本號。

resty -V

如果你使用我們預構建的 Linux 二進位制包安裝 OpenResty，那麼你應該安裝 openresty-resty 包。

dnf list installed openresty-resty

因為它不在 openresty 主包中。

比如用 resty 命令來做“hello world”，就容易多了。

resty -e 'print("Hello World")'

注意 -e 選項。

或者在終端上執行一個 Lua 指令碼。

echo 'print("Hello World")' > hello.lua
cat hello.lua
resty hello.lua

所以這也是使用 OpenResty 編寫新的命令列應用程式的好方法。

這裡也可以實現非阻塞 I/O。

time resty -e 'ngx.sleep(1) ngx.say("done")'

讓我們使用 cosocket API 連線到 openresty.com 的 443 埠。

resty -e 'local sock = ngx.socket.tcp() print(sock:connect("openresty.com", 443))'

或者使用輕執行緒。

resty -e 'ngx.thread.wait(ngx.thread.spawn(function () print("in thread!") end))'

你也可以很容易地使用 Lua 模組。讓我們建立一個 test 模組。

mkdir lua/
vim lua/test.lua

lua/test.lua檔案是這樣的。

local _M = {}

function _M.hello() print("Hello") end

return _M

然後我們使用 -I 選項將 lua/ 目錄新增到 Lua 模組搜尋路徑中。

resty -I lua/ -e 'require "test".hello()'

如果沒有 -I 選項，它就找不到。

resty -e 'require "test".hello()'

這是因為 lua/ 目錄預設不在 Lua 模組的搜尋路徑中。

可以直接載入標準的 Lua 模組，比如 resty.shell。

resty -e 'local ok, stdout = require "resty.shell".run([[echo ok]]) print(stdout)'

該模組用於非阻塞地執行少量 shell 命令。

我們也可以透過 --shdict 選項來定義 lua 共享記憶體字典。

resty --shdict 'dogs 10m' -e 'print(ngx.shared.dogs:set("age", 11))'

可以這樣定義多個共享詞典。

resty --shdict 'dogs 7m' --shdict 'cats 5m' -e 'print(ngx.shared.dogs, " ", ngx.shared.cats)'

它還可以方便地注入自定義的 nginx 配置程式碼。

resty --http-conf 'lua_regex_match_limit 102400;' -e 'print "ok"'

我們還可以玩玩 LuaJIT 的 JIT 編譯器。

讓我們建立一個跑得比較熱的 Lua 指令碼。

echo 'local a = 0 for i = 1, 1e8 do a = a + 1 end print(a)' > bench.lua
cat bench.lua

然後完全禁用 JIT 編譯器。

time resty -joff bench.lua

為了比較，我們可以檢查一下啟用 JIT 編譯器後速度有多快。

time resty bench.lua

或者我們可以用 -jv 選項檢查編譯後的 Lua 程式碼路徑，或者說“traces”。

resty -jv bench.lua

或者有更多的細節，比如編譯後的位元組碼轉儲，IR 程式碼轉儲，以及機器程式碼轉儲。

resty -jdump bench.lua

你可以隨時透過 -h 選項找到所有支援的功能。

resty -h

或者透過“restydoc”工具參考其文件。

restydoc resty-cli

如果你透過我們預建的二進位制包安裝 openresty，那麼你應該安裝 openresty-doc 或 openresty-restydoc 包。

dnf list installed openresty-doc

我們將在另一個專門的影片教程中更深入地瞭解“restydoc”工具。 如果你喜歡這個教程，請訂閱這個部落格網站和我們的 YouTube 頻道 或 B 站頻道。謝謝！

關於本文和關聯影片

本文和相關聯的影片都是完全由我們的 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 多個開源軟體庫。

關注我們

如果您喜歡本文，歡迎關注我們 OpenResty Inc. 公司的部落格網站 。也歡迎掃碼關注我們的微信公眾號：

翻譯

我們提供了英文版原文和中譯版（本文） 。我們也歡迎讀者提供其他語言的翻譯版本，只要是全文翻譯不帶省略，我們都將會考慮採用，非常感謝！