lua读取请求体

yt948322025-06-14 22:15

前言

nginx默认不读取请求体的数据，但可以通过$request_body内置变量来获取。$request_body存在内存中，如果它的字节大小超过nginx配置的client_body_buffer_size的值，nginx就会把请求体存放到临时文件中。此时数据就不在内存中了，这会导致$request_body为空。

同步非阻塞方式获取请求体

ngx.req.read_body

含义：同步读取客户端请求体，且不会阻塞nginx的事件循环。使用此指令后，就可以通过ngx.req.get_body_data来获取请求体的数据了。但如果使用临时文件来存放请求体，就需要先使用函数ngx.req.get_body_file来获取临时文件名，再读取临时文件中的请求体数据。

环境：rewrite_by_lua*、access_by_lua*、content_by_lua*

ngx.req.get_body_data

含义：执行ngx.req.read_body指令后，可以使用本指令在内存中获取请求体数据，结果会返回一个lua的字符串类型的数据。如果要获取table类型的数据，则需要使用ngx.req.get_post_args。

环境：rewrite_by_lua*、access_by_lua*、content_by_lua*、log_by_lua*

ngx.req.get_post_args

含义：读取包含当前请求在内的所有post请求的查询参数，返回一个table类型的数据

环境：rewrite_by_lua*、access_by_lua*、content_by_lua*、log_by_lua*、header_filter_by_lua*、body_filter_by_lua*

ngx.req.get_body_file

含义：获取存放请求体的临时文件名。如果请求体被存放在内存中，获取的值就是nil。

示例

获取string类型的请求体

复制代码

location /testlua {
    client_max_body_size 10k;
    client_body_buffer_size 1k;
    content_by_lua_block {
        local ngx = require "ngx";
        ngx.req.read_body()  -- 开启读取请求体模式
        local data = ngx.req.get_body_data()  -- 获取内存中的请求体
        if data then
            ngx.print(string.format("data: %s, type: %s",data,type(data)))
            return
        else
            local file = ngx.req.get_body_file() -- 如果内存中没有, 则到临时文件中读取
            if file then
                ngx.say("body is in file ", file)
            else
                ngx.say("no body found")
            end
        end
    }
}