第四章 Lua模块开发

╰+哭是因爲堅強的太久メ 2023-10-17 14:05 29阅读 0赞

在实际开发中，不可能把所有代码写到一个大而全的lua文件中，需要进行分模块开发；而且模块化是高性能Lua应用的关键。使用require第一次导入模块后，所有Nginx 进程全局共享模块的数据和代码，每个Worker进程需要时会得到此模块的一个副本（Copy-On-Write），即模块可以认为是每Worker进程共享而不是每Nginx Server共享；另外注意之前我们使用init\_by\_lua中初始化的全局变量是每请求复制一个；如果想在多个Worker进程间共享数据可以使用ngx.shared.DICT或如Redis之类的存储。

在/usr/example/lualib中已经提供了大量第三方开发库如cjson、redis客户端、mysql客户端：

cjson.so

resty/

aes.lua

core.lua

dns/

lock.lua

lrucache/

lrucache.lua

md5.lua

memcached.lua

mysql.lua

random.lua

redis.lua

……

需要注意在使用前需要将库在nginx.conf中导入：

Java代码 ![收藏代码][icon_star.png]

1.  \#lua模块路径，其中”;;”表示默认搜索路径，默认到/usr/servers/nginx下找 
2.  lua\_package\_path "/usr/example/lualib/?.lua;;"; \#lua 模块 
3.  lua\_package\_cpath "/usr/example/lualib/?.so;;"; \#c模块

使用方式是在lua中通过如下方式引入

Java代码 ![收藏代码][icon_star.png]

1.  local cjson = require(“cjson”) 
2.  local redis = require(“resty.redis”)

接下来我们来开发一个简单的lua模块。

Java代码 ![收藏代码][icon_star.png]

1.  vim /usr/example/lualib/module1.lua

Java代码 ![收藏代码][icon_star.png]

1.  local count = 0
2.  local function hello() 
3.   count = count + 1
4.   ngx.say("count : ", count) 
5.  end 
6.  
7.  local \_M = \{ 
8.   hello = hello 
9.  \} 
10. 
11. return \_M

开发时将所有数据做成局部变量/局部函数；通过 \_M导出要暴露的函数，实现模块化封装。

接下来创建test\_module\_1.lua

Java代码 ![收藏代码][icon_star.png]

1.  vim /usr/example/lua/test\_module\_1.lua

Java代码 ![收藏代码][icon_star.png]

1.  local module1 = require("module1") 
2.  
3.  module1.hello()

使用 local var = require("模块名")，该模块会到lua\_package\_path和lua\_package\_cpath声明的的位置查找我们的模块，对于多级目录的使用require("目录1.目录2.模块名")加载。

example.conf配置

Java代码 ![收藏代码][icon_star.png]

1.  location /lua\_module\_1 \{ 
2.   default\_type 'text/html'; 
3.   lua\_code\_cache on; 
4.   content\_by\_lua\_file /usr/example/lua/test\_module\_1.lua; 
5.  \}

访问如http://192.168.1.2/lua\_module\_1进行测试，会得到类似如下的数据，count会递增

count : 1

count ：2

……

count ：N

此时可能发现count一直递增，假设我们的worker\_processes 2，我们可以通过kill -9 nginx worker process杀死其中一个Worker进程得到count数据变化。

假设我们创建了vim /usr/example/lualib/test/module2.lua模块，可以通过local module2 = require("test.module2")加载模块

基本的模块开发就完成了，如果是只读数据可以通过模块中声明local变量存储；如果想在每Worker进程共享，请考虑竞争；如果要在多个Worker进程间共享请考虑使用ngx.shared.DICT或如Redis存储。

来源:http://jinnianshilongnian.iteye.com/blog/2187067

[icon_star.png]: http://jinnianshilongnian.iteye.com/images/icon_star.png