Nginx系列 | [转]Nginx 上传文件：client_max_body_size 、client_body_buffer_size

原文：http://php-note.com/article/detail/488

client_max_body_size

client_max_body_size 默认 1M，表示 客户端请求服务器最大容许大小，在“Content-Length”请求头中指定。若是请求的正文数据大于client_max_body_size，HTTP协议会报错 413 Request Entity Too Large。就是说若是请求的正文大于client_max_body_size，必定是失败的。若是须要上传大文件，必定要修改该值。

client_body_buffer_size

Nginx分配给请求数据的Buffer大小，若是请求的数据小于client_body_buffer_size直接将数据先在内存中存储。若是请求的值大于client_body_buffer_size小于client_max_body_size，就会将数据先存储到临时文件中，在哪一个临时文件中呢？

client_body_temp 指定的路径中，默认该路径值是/tmp/。

因此配置的client_body_temp地址，必定让执行的Nginx的用户组有读写权限。不然，当传输的数据大于client_body_buffer_size，写进临时文件失败会报错。

这个问题咱们遇到过。

20648 open() "/usr/local/openresty-1.9.7.5/nginx/client_body_temp/0000000019" failed (13: Permission denied)

/usr/local/openresty-1.9.7.5/nginx/client_body_temp/这个文件夹权限改成执行Nginx的用户群组就能够解决。

在这个问题上和语言就相关了，若是使用的是PHP，PHP会本身将临时文件读取出来，放置到请求数据里面，这是没有问题的，开发者也不须要关心。确定是完整的数据。

若是使用的openresty lua 开发的话，就须要开发者本身读取出来，让后续的逻辑使用。

function getFile(file_name)
    local f = assert(io.open(file_name, 'r'))
    local string = f:read("*all")
    f:close()
    return string
end
 
ngx.req.read_body()
local data = ngx.req.get_body_data()
if nil == data then
    local file_name = ngx.req.get_body_file()
    ngx.say(">> temp file: ", file_name)
    if file_name then
        data = getFile(file_name)
    end
end
 
ngx.say("hello ", data)

总结

• 传输的数据大于 client_max_body_size，必定是传不成功的。
• 小于 client_body_buffer_size直接在内存中高效存储。
• 若是大于 client_body_buffer_size 小于 client_max_body_size 会存储临时文件，临时文件必定要有权限。
• 若是追求效率，就设置 client_max_body_size 和 client_body_buffer_size 相同的值，这样就不会存储临时文件，直接存储在内存了。