07 带你快速上手 Lua 你好,我是温铭。

在大概了解 NGINX 的基础知识后,接下来,我们就要来进一步学习 Lua了。它是 OpenResty 中使用的编程语言,掌握它的基本语法还是很有必要的。

Lua 是一个小巧精妙的脚本语言,诞生于巴西的大学实验室,这个名字在葡萄牙语里的含义是“美丽的月亮”。从作者所在的国家来看,NGINX 诞生于俄罗斯,Lua 诞生于巴西,OpenResty 诞生于中国,这三门同样精巧的开源技术都出自金砖国家,而不是欧美,也是挺有趣的一件事。

回到Lua语言上。事实上,Lua 在设计之初,就把自己定位为一个简单、轻量、可嵌入的胶水语言,没有走大而全的路线。虽然你平常工作中可能没有直接编写 Lua 代码,但 Lua 的使用其实非常广泛。很多的网游,比如魔兽世界,都会采用 Lua 来编写插件;而键值数据库 Redis 则是内置了 Lua 来控制逻辑。

另一方面,虽然 Lua 自身的库比较简单,但它可以方便地调用 C 库,大量成熟的 C 代码都可以为其所用。比如在 OpenResty 中,很多时候都需要你调用 NGINX 和 OpenSSL 的 C 函数,而这都得益于 Lua 和 LuaJIT 这种方便调用 C 库的能力。

下面,我带你来快速熟悉下 Lua 的数据类型和语法,以便你后面更顺畅地学习 OpenResty。

环境和 hello world

我们不用专门去安装标准 Lua 5.1 之类的环境,因为 OpenResty 已经不再支持标准 Lua,而只支持 LuaJIT。这里我介绍的 Lua 语法,也是和 LuaJIT 兼容的部分,而不是基于最新的 Lua 5.3,这一点需要你特别注意。

在 OpenResty 的安装目录下,你可以找到 LuaJIT 的目录和可执行文件。我这里是 Mac 环境,使用 brew 安装 OpenResty,所以你本地的路径很可能和下面的不同: $ ll /usr/local/Cellar/openresty/1.13.6.2/luajit/bin/luajit lrwxr-xr-x 1 ming admin 18B 4 2 14:54 /usr/local/Cellar/openresty/1.13.6.2/luajit/bin/luajit -> luajit-2.1.0-beta3

你也可以在系统的可执行文件目录中找到它:

$ which luajit /usr/local/bin/luajit

并查看 LuaJIT 的版本号:

$ luajit -v LuaJIT 2.1.0-beta2 – Copyright (C) 2005-2017 Mike Pall. http://luajit.org/

查清楚这些信息后,你可以新建一个

1.lua 文件,并用 luajit 来运行其中的 hello world 代码:

$ cat 1.lua print(“hello world”) $ luajit 1.lua hello world

当然,你还可以使用

resty 来直接运行,要知道,它最终也是用 LuaJIT 来执行的:

$ resty -e ‘print(“hello world”)’ hello world

上述两种运行 hello world 的方式都是可行的。不顾对我来说,我更喜欢

resty 这种方式,因为后面很多 OpenResty 的代码,也都是通过

resty 来运行的。

数据类型

Lua 中的数据类型不多,你可以通过

type 函数来返回一个值的类型,比如下面这样的操作: $ resty -e ‘print(type(“hello world”)) print(type(print)) print(type(true)) print(type(360.0)) print(type({})) print(type(nil)) ‘

会打印出如下内容:

string function boolean number table nil

这几种就是 Lua 中的基本数据类型了。下面我们来简单介绍一下它们。

字符串

在 Lua 中,字符串是不可变的值,如果你要修改某个字符串,就等于创建了一个新的字符串。这种做法显然有利有弊:好处是即使同一个字符串出现了很多次,在内存中也只有一份;但劣势也很明显,如果你想修改、拼接字符串,会额外地创建很多不必要的字符串。

我们举一个例子,来说明这个弊端。下面这段代码,是把 1 到 10 这些数字当作字符串拼接起来。对了,在 Lua 中,我们使用两个点号来表示字符串的相加: $ resty -e ‘local s = “” for i = 1, 10 do s = s .. tostring(i) end print(s)’

这里我们循环了 10 次,但只有最后一次是我们想要的,而中间新建的 9 个字符串都是无用的。它们不仅占用了额外的空间,也消耗了不必要的 CPU 运算。

当然,在后面的性能优化章节,我们会有对应的方法来解决它。

另外,在 Lua 中,你有三种方式可以表达一个字符串:单引号、双引号,以及长括号(

[[]] )。前面两种都比较好理解,别的语言一般也这么用,那么长括号有什么用处呢?

我们看一个具体的示例: $ resty -e ‘print([[string has \n and \r]])’ string has \n and \r

你可以看到,长括号中的字符串不会做任何的转义处理。

你也许会问另外一个问题:如果上面那段字符串中包括了长括号本身,又该怎么处理呢?答案很简单,就是在长括号中间增加一个或者多个

= 符号: $ resty -e ‘print([=[ string has a [[]]. ]=])’ string has a [[]].

布尔值

这个很简单,true 和 false。但在 Lua 中,只有 nil 和 false 为假,其他都为真,包括 0 和空字符串也为真。我们可以用下面的代码印证一下: $ resty -e ‘local a = 0 if a then print(“true”) end a = “” if a then print(“true”) end’

这种判断方式和很多常见的开发语言并不一致,所以,为了避免在这种问题上出错,你可以显式地写明比较的对象,比如下面这样:

$ resty -e ‘local a = 0 if a == false then print(“true”) end ‘

数字

Lua 的 number 类型,是用双精度浮点数来实现的。值得一提的是,LuaJIT 支持

dual-number (双数)模式,也就是说, LuaJIT 会根据上下文来用整型来存储整数,而用双精度浮点数来存放浮点数。

此外,LuaJIT 还支持

长长整型 的大整数,比如下面的例子: $ resty -e ‘print(9223372036854775807LL - 1)’ 9223372036854775806LL

函数

函数在 Lua 中是一等公民,你可以把函数存放在一个变量中,也可以当作另外一个函数的入参和出参。

比如,下面两个函数的声明是完全等价的: function foo() end

foo = function () end

table

table 是 Lua 中唯一的数据结构,自然非常重要,所以后面我会用专门的章节来介绍它。我们可以先来看一个简单的示例代码: $ resty -e ‘local color = {first = “red”} print(color[“first”])’ red

空值

在 Lua 中,空值就是 nil。如果你定义了一个变量,但没有赋值,它的默认值就是 nil: $ resty -e ‘local a print(type(a))’ nil

当你真正进入 OpenResty 体系中后,会发现很多种空值,比如

ngx.null 等等,我们后面再细聊。

Lua的数据类型,我主要就介绍这么多,先给你打个基础。一些需要重点掌握的内容,后面的文章中我们都会继续学习。在练习、使用中学习,永远是吸收新知识最便捷的方式。

常用标准库

很多时候,我们学习一门语言,其实就是在学习它的标准库。

Lua 比较小巧,内置的标准库并不多。而且,在 OpenResty 的环境中,Lua 标准库的优先级是很低的。对于同一个功能,我更推荐你优先使用 OpenResty 的 API 来解决,然后是 LuaJIT 的库函数,最后才是标准 Lua 的函数。

OpenResty的API > LuaJIT的库函数 > 标准Lua的函数 ,这个优先级后面会被反复提及,它不仅关系到是否好用这一点,更会对性能产生非常大的影响。

不过,尽管如此,在实际的项目开发中,我们还是不可避免会用到一些 Lua 库。这里,我挑选了几个比较常用的标准库做下介绍,如果你想要了解更多内容,可以查阅 Lua 的官方文档。

string 库

字符串操作是我们最常用到的,也是坑最多的地方。有一个简单的原则,那就是如果涉及到正则表达式的,请一定要使用 OpenResty 提供的

ngx.re./* 来解决,不要用 Lua 的

string./* 处理。这是因为,Lua 的正则独树一帜,不符合 PCRE 的规范,我相信绝大部分工程师是玩不转的。

其中

string.byte(s [, i [, j ]]) ,是比较常用到的一个 string 库函数,它返回字符 s[i]、s[i + 1]、s[i + 2]、······、s[j] 所对应的 ASCII 码。i 的默认值为 1,即第一个字节,j 的默认值为 i。

下面我们来看一段示例代码: $ resty -e ‘print(string.byte(“abc”, 1, 3)) print(string.byte(“abc”, 3)) – 缺少第三个参数,第三个参数默认与第二个相同,此时为 3 print(string.byte(“abc”)) – 缺少第二个和第三个参数,此时这两个参数都默认为 1 ‘

它的输出为:

979899 99 97

table 库

在 OpenResty 的上下文中,对于Lua 自带的 table 库,除了

table.concat 、

table.sort 等少数几个函数,大部分我都不推荐使用。至于它们的细节,我们留在 LuaJIT 章节中专门来讲。

这里我简单提一下

table.concat 。

table.concat 一般用在字符串拼接的场景下,比如下面这个例子。它可以避免生成很多无用的字符串。 $ resty -e ‘local a = {“A”, “b”, “C”} print(table.concat(a))’

math 库

Lua math 库由一组标准的数学函数构成。数学库的引入,既丰富了 Lua 编程语言的功能,同时也方便了程序的编写。

在 OpenResty 的实际项目中,我们很少用 Lua 去做数学方面的运算,不过其中和随机数相关的

math.random() 和

math.randomseed() 两个函数,倒是比较常用,比如下面的这段代码,它可以在指定的范围内,随机地生成两个数字。 $ resty -e ‘math.randomseed (os.time()) print(math.random()) print(math.random(100))’

虚变量

了解了这些常见的标准库,接下来,我们再来学习一个新的概念——虚变量。

设想这么一个场景,当一个函数返回多个值的时候,有些返回值我们并不需要,这时候,应该怎么接收这些值呢?

不知道你是怎么看待这件事的,起码对我来说,要想法设法给这些用不到的变量,去赋予有意义的名字,着实是一件很折磨人的事情。

还好, Lua 中可以完美地解决这一点。Lua 提供了一个虚变量(dummy variable)的概念, 按照惯例以一个下划线来命名,用来表示丢弃不需要的数值,仅仅起到占位的作用。

下面我们以

string.find 这个标准库函数为例,来看虚变量的用法。这个标准库函数会返回两个值,分别代表开始和结束的下标。

如果我们只需要获取开始的下标,那么很简单,只声明一个变量来接收

string.find 的返回值即可: $ resty -e ‘local start = string.find(“hello”, “he”) print(start)’ 1

但如果你只想获取结束的下标,那就必须使用虚变量了:

$ resty -e ‘local _, end_pos = string.find(“hello”, “he”) print(end_pos)’ 2

除了在返回值里使用,虚变量还经常用于循环中,比如下面这个例子:

$ resty -e ‘for _, v in ipairs({4,5,6}) do print(v) end’ 4 5 6

而当有多个返回值需要忽略时,你可以重复使用同一个虚变量。这里我就不举例子了,你可以试着自己写一个这样的示例代码吗?欢迎你把代码贴在留言区里和我分享、交流。

写在最后

今天,我们一起快速地学习了标准 Lua 的数据结构和语法,相信你对这门简单精巧的语言已经有了初步的了解。下节课,我会带你了解 Lua 和 LuaJIT 的关系,LuaJIT 更是 OpenResty 中的重头戏,值得我们深入挖掘。

最后,我想再为你留下一道思考题。

还记得这节课讲math库时,学过的这段代码吗?它可以在指定范围内,随机生成两个数字。 $ resty -e ‘math.randomseed (os.time()) print(math.random()) print(math.random(100))’

不过,你可能注意到了,这段代码是用当前时间戳作为种子的,那么这种方法是否有问题呢?又该如何生成好的种子呢?要知道,很多时候我们生成的随机数其实并不随机,并且有很大的安全隐患。

欢迎在留言区来说说你的看法,也欢迎你把这篇文章转发给你的同事、朋友。我们一起交流、一起进步。

参考资料

https://learn.lianglianglee.com/%e4%b8%93%e6%a0%8f/OpenResty%e4%bb%8e%e5%85%a5%e9%97%a8%e5%88%b0%e5%ae%9e%e6%88%98/07%20%e5%b8%a6%e4%bd%a0%e5%bf%ab%e9%80%9f%e4%b8%8a%e6%89%8b%20Lua.md