nginx上传模块---nginx upload module

梦里梦外; 2022-01-16 23:33 632阅读 0赞

[为什么80%的码农都做不了架构师？>>> ][80_]  ![hot3.png][]

nginx上传模块 一. nginx upload module原理 官方文档： [http://www.grid.net.ru/nginx/upload.en.html][http_www.grid.net.ru_nginx_upload.en.html] Nginx upload module通过nginx服务来接受用户上传的文件，自动解析请求体中存储的所有文件上传到upload\_store指定的目录下。这些文件信息从原始请求体中分离并根据nginx.conf中的配置重新组装好上传参数，交由upload\_pass指定的段处理，从而允许处理任意上传文件。每个上传文件中的file字段值被一系列的upload\_set\_form\_field指令值替换。每个上传文件的内容可以从$upload\_tmp\_path变量读取，或者可以将文件转移到目的目录下。上传的文件移除可以通过upload\_cleanup指令控制。如果请求的方法不是POST，模块将返回405错误(405 Not Allowed)，该错误提示可以通过error\_page指令处理。 具体的过程如下： 1. 用户访问能够选择上传文件的页面 2. 用户提交表单 3. 浏览器把文件和有关文件的信息作为请求的一部分发送给服务器 4. 服务器把文件保存到临时存储目录下upload\_store 5. upload\_pass指定的处理表单提交的php页面将文件从upload\_store拷贝到持久存储位置 二.nginx upload module配置参数 upload\_pass 指明后续处理的php地址。文件中的字段将被分离和取代，包含必要的信息处理上传文件。 upload\_resumable 是否启动可恢复上传。 upload\_store 指定上传文件存放地址(目录)。目录可以散列，在这种情况下，在nginx启动前，所有的子目录必须存在。 upload\_state\_store 指定保存上传文件可恢复上传的文件状态信息目录。目录可以散列，在这种情况下，在nginx启动前，所有的子目录必须存在。 upload\_store\_access 上传文件的访问权限，user:r是指用户可读 upload\_pass\_form\_field 从表单原样转到后端的参数，可以正则表达式表示。： $upload\_field\_name -- 原始文件中的字段的名称 upload\_pass\_form\_field "^submit$|^description$"; 意思是把submit，description这两个字段也原样通过upload\_pass传递到后端php处理。如果希望把所有的表单字段都传给后端可以用upload\_pass\_form\_field "^.\*$"; upload\_set\_form\_field 名称和值都可能包含以下特殊变量： $upload\_field\_name 表单的name值 $upload\_content\_type 上传文件的类型 $upload\_file\_name 客户端上传的原始文件名称 $upload\_tmp\_path 文件上传后保存在服务端的位置 upload\_aggregate\_form\_field 可以多使用的几个变量,文件接收完毕后生成的并传递到后端 $upload\_file\_md5 文件的MD5校验值 $upload\_file\_md5\_uc 大写字母表示的MD5校验值 $upload\_file\_sha1 文件的SHA1校验值 $upload\_file\_sha1\_uc 大写字母表示的SHA1校验值 $upload\_file\_crc32 16进制表示的文件CRC32值 $upload\_file\_size 文件大小 $upload\_file\_number 请求体中的文件序号 这些字段值是在文件成功上传后计算的。 upload\_cleanup 如果出现400 404 499 500-505之类的错误，则删除上传的文件 upload\_buffer\_size 上传缓冲区大小 upload\_max\_part\_header\_len 指定头部分最大长度字节。 upload\_max\_file\_size 指定上传文件最大大小，软限制。client\_max\_body\_size硬限制。 upload\_limit\_rate 上传限速，如果设置为0则表示不限制。 upload\_max\_output\_body\_len 超过这个大小，将报403错(Request entity too large)。 upload\_tame\_arrays 指定文件字段名的方括号是否删除 upload\_pass\_args 是否转发参数。 三. nginx配置 \# wget http://www.nginx.org/download/nginx-1.2.2.tar.gz \# wget http://www.grid.net.ru/nginx/download/nginx\_upload\_module-2.2.0.tar.gz \# tar zxvf nginx\_upload\_module-2.2.0.tar.gz -c ../software/ \# tar zxvf nginx\_upload\_module-2.2.0.tar.gz -C ../software/ \# ./configure --prefix=/usr/local/nginx --add-module=../nginx\_upload\_module-2.2.0 --with-http\_secure\_link\_module \# make \# make install \# vi nginx.conf user www-data; worker\_processes 20; error\_log logs/error.log notice; working\_directory /usr/local/nginx; events \{ worker\_connections 1024; \} http \{ include mime.types; default\_type application/octet-stream; root /www/web/upload; server \{ listen 80; server\_name 192.168.41.129;   error\_page 405 =200 @405; //处理405错误 location / \{ index index.html index.htm index.php; \} location @405 \{ root /www/web/upload; \} location ~ \\.php$ \{ try\_files $uri /404.html; fastcgi\_pass 127.0.0.1:9000; fastcgi\_index index.php; fastcgi\_param SCRIPT\_FILENAME $document\_root$fastcgi\_script\_name; include /etc/nginx/fastcgi\_params; \} client\_max\_body\_size 100m; \# 上传页面提交到这个location location /upload \{ \# 文件上传以后转交给后端的php代码处理 upload\_pass [@test][test] ; \# 上传文件的临时存储位置，目录是散列的，应该存在子目录0 1 2 3 4 5 6 7 8 9 upload\_store /www/web/upload/tmp 1; upload\_store\_access user:r; \# 设置请求体的字段 upload\_set\_form\_field "$\{upload\_field\_name\}\_name" $upload\_file\_name; upload\_set\_form\_field "$\{upload\_field\_name\}\_content\_type" $upload\_content\_type; upload\_set\_form\_field "$\{upload\_field\_name\}\_path" $upload\_tmp\_path; \# 指示后端关于上传文件的md5值和文件大小 upload\_aggregate\_form\_field "$\{upload\_field\_name\}\_md5" $upload\_file\_md5; upload\_aggregate\_form\_field "$\{upload\_field\_name\}\_size" $upload\_file\_size; \# 指示原样转到后端的参数，可以用正则表达式表示 upload\_pass\_form\_field "^submit$|^description$"; upload\_pass\_args on; \} \# 将请求转到后端的地址处理 location [@test][test] \{ rewrite ^(.\*)$ /test.php last; \} \} \} 四. 上传界面 \# cat /www/web/upload/upload.html <html> <head> <title>Test upload</title> </head> <body> <h2>Select files to upload</h2> <form enctype="multipart/form-data" action="/upload" method="post"> <input type="file" name="file1"><br> <input type="file" name="file2"><br> <input type="file" name="file3"><br> <input type="file" name="file4"><br> <input type="file" name="file5"><br> <input type="file" name="file6"><br> <input type="submit" name="submit" value="Upload"> <input type="hidden" name="test" value="value"> </form> </body> </html> 五. upload\_pass处理内容 \# cat test.php //这里只是简单的打印出来，便于先理解上传原理。请对着输出内容理解下nginx upload module配置参数。 <?php print\_r($\_POST); ?> 对上传文件的处理请参考：http://cn.php.net/manual/en/features.file-upload.php 六. 测试 http://192.168.41.129/upload.html 输出内容如下所示： Array ( \[file1\_name\] => Learning Perl, Sixth Edition.pdf \[file1\_content\_type\] => application/pdf \[file1\_path\] => /www/web/upload/tmp/4/0000000014 \[file1\_md5\] => 87032cc58109f5c6bb866d2684f9b48c \[file1\_size\] => 8927511 \[file2\_name\] => Programming Perl, 4th Edition.pdf \[file2\_content\_type\] => application/pdf \[file2\_path\] => /www/web/upload/tmp/5/0000000015 \[file2\_md5\] => 82a52df177a8912c06af276581cfd5e4 \[file2\_size\] => 21146356 \[submit\] => Upload ) 注意：需要修改php.ini以下参数 file\_uploads on 是否允许通过http上传 upload\_max\_filesize 8m 允许上传文件的最大大小 post\_max\_size 8m 通过表单POST给php所能接收的最大值 另外nginx.conf中设置上传文件大小 upload\_max\_file\_size 软限制 client\_max\_body\_size 硬限制

转载于:https://my.oschina.net/766/blog/211450

[80_]: https://my.oschina.net/u/2663968/blog/3051541
[hot3.png]: /images/20220117/54b5cbca8e35473dac44ec92418c8769.png
[http_www.grid.net.ru_nginx_upload.en.html]: http://www.grid.net.ru/nginx/upload.en.html
[test]: http://my.oschina.net/azibug