ngx_lua模块进行web开发的常见问题解答

[list]
  • 如何获取HTTP请求头?




  • 直接在 ngx_lua 中访问 NginX 内置变量 ngx.var.http_HEADER 即可获得请求头 HEADER 的内容。对于常见的特殊头(Content-Type、Cookie 等),NginX 还使用了特殊的变量来独立保存,例如“Content-Type”头可以通过 ngx.var.content_type 变量取得。


  • 如何获取GET参数?




  • 在 ngx_lua 中访问 NginX 内置变量 ngx.var.arg_PARAMETER 即可获得GET参数PARAMETER的内容。


  • 如何获取POST请求体数据?




  • 要获得完整的POST请求体数据,可以访问 NginX 内置变量 ngx.var.request_body(注意:由于 NginX 默认在处理请求前不自动读取 request body,所以目前必须显式借助 form-input-nginx 模块才能从该变量得到请求体,否则该变量内容始终为空!)。如果想获取 POST 方式提交的表单参数,还可以借助 form-input-nginx 模块省去解析过程。例如:

    location /form {
        set_form_input $name;
        content_by_lua '
            local name = ngx.var.name or "";
            local say = ngx.say
            say("My name is: ", name)
        ';
    }
    

  • 如何设置/获取HTTP响应头?




  • 我们已经设计了对应的API接口,近期即会予以实现。

  • 如何使用 Lua 外部模块?

  • 通过 require 引用即可,和在普通的 Lua 代码里一样。需要注意的一点是,通过 require 引用外部模块一般有 2 种写法。老的写法是:

    require("xxx")
    


    这样会将模块命名空间表直接导入当前全局环境内;而新的写法是:

    local xxx = require("xxx")
    


    这样的写法将模块命名空间表缓存在同名局部变量中,访问更快,也不会污染当前全局环境。但最重要的一点是: 老的写法在 ngx_lua 中会出现模块导入后无法访问的现象!这是由 ngx_lua 实现原理决定的。ngx_lua 使用每请求一个 coroutine 的方式运行用户代码,coroutine 的全局环境是重新关联的,因此用户代码相当于运行在一个沙盒中,请求处理结束后用户代码产生的所有全局环境修改都会被舍弃,避免多个请求之间产生交叉影响,也降低了因滥用全局环境产生内存泄漏的风险。而 require 利用了全局共享的 package.loaded 表缓存已载入模块的数据,以达到避免重复加载模块的目的。很明显,这种结构必然会使首个请求中通过 require 注入全局环境的模块命名空间表在后续请求中无法访问,因为后续请求中 package.loaded 表内已经有之前加载模块的数据,故 require 不会再次将命名空间表注入当前全局环境,使得以后所有依赖于模块的操作都失败。

    鉴于这一问题, 我们推荐开发人员总是使用新的 require 写法(即使用局部变量缓存模块表),对于那些因为某种原因无法更新 require 写法的代码,可以通过在开始处理请求前清空 package.loaded 表中对应模块数据的方式强制加载模块并注入全局环境(注意每次都加载模块可能产生性能瓶颈!),例如:

    package.loaded.xxx = nil
    require("xxx")
    


    [/list]

    参考:

    1. http://wiki.nginx.org/NginxHttpCoreModule#Variables
    2. http://github.com/calio/form-input-nginx-module


    猜你喜欢

    转载自chaoslawful.iteye.com/blog/730463
    今日推荐