ngx.req.get_body_data() 读请求体，会偶尔出现读取不到直接返回 nil 的情况。

如果请求体尚未被读取，请先调用 ngx.req.read_body (或打开 lua_need_request_body 选项强制本模块读取请求体，此方法不推荐）。

如果请求体已经被存入临时文件，请使用 ngx.req.get_body_file 函数代替。

如需要强制在内存中保存请求体，请设置 client_body_buffer_size 和 client_max_body_size 为同样大小。

1、ngx.req.read_body

语法: ngx.req.read_body()
作用域: rewrite_by_lua*, access_by_lua*, content_by_lua*

开启获取请求中的body内容。

结论：

1、lua_need_request_body 开启后，该函数不执行。
2、如果在该函数前执行 ngx.req.discard_body()，该函数不执行。

2、ngx.req.discard_body

语法: ngx.req.discard_body()
作用域: rewrite_by_lua*, access_by_lua*, content_by_lua*

禁止获取请求中的body内容。

语法: data = ngx.req.get_body_data()
作用域: rewrite_by_lua*, access_by_lua*, content_by_lua*, log_by_lua*

获取请求body的内容，返回字符串。

注意：如果使用 ngx.req.get_post_args()，则返回一个lua table。

以下三种情况返回 nil：

未使用 ngx.req.read_body 读取请求 body，或未打开lua_need_request_body 。
请求 body 的内容已经写入临时文件；此时使用 ngx.req.get_body_file 获取，或设置 client_body_buffer_size 和 client_max_body_size同等大小，来避免请求body写入临时文件。
请求体的内容为空。

语法: file_name = ngx.req.get_body_file()
作用域: rewrite_by_lua*, access_by_lua*, content_by_lua*

返回请求body写入的临时文件。例如：返回

/usr/local/openresty/nginx/client_body_temp/0000000019

注意以下2种情况会写入临时文件：

1、请求body的长度超过nginx.conf定义的 client_body_buffer_size 大小。
2、nginx.conf开启 client_body_in_file_only on (请求body始终写入临时文件)

语法: ngx.req.set_body_data(data)
作用域: rewrite_by_lua*, access_by_lua*, content_by_lua*

设置请求body的内容，一般用于转发请求到子请求。

注意：

1、在使用该方法时，必需确保当前请求已经使用 ngx.req.read_body() 或者 lua_need_read_body on，否则，在使用该方法会报 500 错误。

例如：

ngx.req.read_body() --如果该行省略，将直接报错。
ngx.req.set_body_data("abc")
ngx.exec("/app/detail")

语法: ngx.req.set_body_file(file_name, auto_clean?)
作用域: rewrite_by_lua*, access_by_lua*, content_by_lua*

语法: ngx.req.init_body(buffer_size?)
作用域: set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*

语法: ngx.req.append_body(data_chunk)
作用域: set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*

语法: ngx.req.finish_body()
作用域: set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*