resty 命令行工具演示

在本教程中，我们将演示如何使用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 XRay 产品提升您应用的性能

关于本文和关联视频

本文和相关联的视频都是完全由我们的 OpenResty Demo 系统从一个极简单的剧本文件自动生成的。

关于作者

章亦春是开源项目 OpenResty^® 的创始人，同时也是 OpenResty Inc. 公司的创始人和 CEO。他贡献了许多 Nginx 的第三方模块，相当多 Nginx 和 LuaJIT 核心补丁，并且设计了 OpenResty XRay 等产品。

关注我们

如果您觉得本文有价值，非常欢迎关注我们 OpenResty Inc. 公司的博客网站 。也欢迎扫码关注我们的微信公众号：

翻译

我们提供了英文版原文和中译版（本文） 。我们也欢迎读者提供其他语言的翻译版本，只要是全文翻译不带省略，我们都将会考虑采用，非常感谢！

申请 OpenResty XRay 的产品演示