第四章 Lua模块开发

来源:互联网 发布:淘宝联盟高佣活动入口 编辑:程序博客网 时间:2024/06/07 02:29

在实际开发中,不可能把所有代码写到一个大而全的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代码  收藏代码
  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代码  收藏代码
  1. local cjson = require(“cjson”)  
  2. local redis = require(“resty.redis”)   

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

Java代码  收藏代码
  1. vim /usr/example/lualib/module1.lua  
Java代码  收藏代码
  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代码  收藏代码
  1. vim /usr/example/lua/test_module_1.lua  
Java代码  收藏代码
  1. local module1 = require("module1")  
  2.   
  3. module1.hello()  

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

 

example.conf配置

Java代码  收藏代码
  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