轉：使用 Nginx Upload Module 實現上傳檔案功能

標籤：size   client   自動   功能   類比   lin   set   handle   write   

普通網站在實現檔案上傳功能的時候，一般是使用Python，Java等後端程式實現，比較麻煩。Nginx有一個Upload模組，可以非常簡單的實現檔案上傳功能。此模組的原理是先把使用者上傳的檔案儲存到臨時檔案，然後在交由後台頁面處理，並且把檔案的原名，上傳後的名稱，檔案類型，檔案大小set到頁面。下面和大傢具體介紹一下。

一、編譯安裝Nginx

為了使用Nginx Upload Module，需要編譯安裝Nginx，將upload module編譯進去。upload module的代碼可以去Github上下載： Upload Module

之後的編譯安裝Nginx這裡就不介紹，不瞭解的可以參考： Ubuntu 14.10下源碼編譯安裝Nginx 1.8.0

二、Nginx配置

Nginx upload module的簡單配置如下：

server {    listen *:80 default_server;    server_name 192.168.1.251;    client_max_body_size 20m;    client_body_buffer_size 512k;    proxy_set_header Host $host;    proxy_set_header X-Real-IP $remote_addr;    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    proxy_set_header REMOTE_ADD $remote_addr;    location /upload {# 轉到幕後處理URL,表示Nginx接收完上傳的檔案後，然後交給後端處理的地址upload_pass @python;# 臨時儲存路徑, 可以使用散列# 上傳模組已接收的檔案臨時存放的路徑， 1 表示方式，該方式是需要在/tmp/nginx_upload下建立以0到9為目錄名稱的目錄，上傳時候會進行一個散列處理。upload_store /tmp/nginx_upload;# 上傳檔案的許可權，rw表示讀寫 r唯讀upload_store_access user:rw group:rw all:rw;set $upload_field_name "file";# upload_resumable on;# 這裡寫入http前序，pass到後台頁面後能擷取這裡set的前序欄位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;# Upload模組自動產生的一些資訊，如檔案大小與檔案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 "^.*$";# upload_pass_form_field "^submit$|^description$";# 每秒位元組速度控制，0表示不受控制，預設0, 128Kupload_limit_rate 0;# 如果pass頁面是以下狀態代碼，就刪除此次上傳的臨時檔案upload_cleanup 400 404 499 500-505;# 開啟開關，意思就是把前端指令碼請求的參數會傳給後端的指令碼語言，比如：http://192.168.1.251:9000/upload/?k=23,後台可以通過POST[‘k‘]來訪問。upload_pass_args on;      }    location @python {proxy_pass http://localhost:9999;# return 200;  # 如果不需要後端程式處理，直接返回200即可    }}

三、後端處理常式

這裡我們使用Django作為後端處理常式，比較簡單，具體如下：

首先建立Django項目：

django-admin.py startproject uploadmodule

然後，建立views.py檔案，代碼如下：

# -*- coding: utf-8 -*-import osimport jsonfrom django.http import HttpResponsefrom django.views.decorators.csrf import csrf_exemptUPLOAD_FILE_PATH = ‘/tmp/nginx_upload/‘@csrf_exemptdef upload(request):request_params = request.POSTfile_name = request_params[‘file_name‘]file_content_type = request_params[‘file_content_type‘]file_md5 = request_params[‘file_md5‘]file_path = request_params[‘file_path‘]file_size = request_params[‘file_size‘]ip_address = request.META.get(‘HTTP_X_REAL_IP‘) or request.META.get(‘HTTP_REMOTE_ADD‘)# save file to tmpnew_file_name = ‘%s_%s‘ % (file_md5, ip_address)new_file_path = ‘‘.join([UPLOAD_FILE_PATH, new_file_name, os.path.splitext(file_name)[-1]])with open(new_file_path, ‘a‘) as new_file:with open(file_path, ‘rb‘) as f:new_file.write(f.read())content = json.dumps({‘name‘: file_name,‘content_type‘: file_content_type,‘md5‘: file_md5,‘path‘: file_path,‘size‘: file_size,‘ip‘: ip_address,})response = HttpResponse(content, content_type=‘application/json; charset=utf-8‘)return response

四、樣本

上面的程式碼完成之後，我們通過下面的命令啟動Django後端程式：

cd uploadmodule/python manage.py runserver 0.0.0.0:9999

然後，類比POST請求：http://192.168.1.251/upload/，上傳一個jpg檔案，返回結果如下：

{"name": "6125444419718417450.jpg","ip": "192.168.1.121","content_type": "image/jpeg","path": "/tmp/nginx_upload/0000000002","md5": "c3b1bd2e72694a8d5fc4548b9ecd9e18","size": "37980"}

參考：

Ubuntu 14.10下源碼編譯安裝Nginx 1.8.0

HttpUploadModule - Nginx Community

vkholodkov/nginx-upload-module at 2.2

Uploading to nginx using the nginx upload module with php_handler

Over!

轉：使用 Nginx Upload Module 實現上傳檔案功能