5 分鐘，帶你快速入門 Django 文件上傳下載
點擊上方“AirPython”，選擇“加為星標(biāo)”
第一時間關(guān)注 Python 原創(chuàng)干貨！
1. 前言
大家好，我是安果！
文件上傳、下載作為基礎(chǔ)功能，在 Web 項目中非常普遍，Django 項目如何實現(xiàn)文件上傳下載？
本篇文章將帶大家 5 分鐘快速實現(xiàn)文件上傳下載功能
2. 實戰(zhàn)一下
詳細(xì)實現(xiàn)步驟如下（ 9 步）
2-1 進入虛擬環(huán)境，創(chuàng)建一個項目及 App
workon django3
# 創(chuàng)建項目
django-admin startproject file_up_and_down_demo
# 進入項目根目錄
cd file_up_and_down_demo/
# 創(chuàng)建一個App
django-admin startapp index
2-2 創(chuàng)建模板目錄并配置 settings.py
在 index App 下創(chuàng)建一個 templates 文件夾，然后在項目配置文件 settings.py 中配置 App 及模板目錄
# settings.py
# 配置App
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'index',
]
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [
# 配置模板目錄
os.path.join(BASE_DIR, 'index/templates')
],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]
2-3 創(chuàng)建文件模型，并映射到數(shù)據(jù)庫
以默認(rèn)的 sqlite 為例，在 index App 下的 models.py 中自定義一個代表文件的模型
該模型包含 3 個字段：
文件名稱
文件保存路徑
上傳時間
# index App models.py
from django.db import models
from django.utils import timezone
# 文件模型
class FileModel(models.Model):
# 文件名稱
name = models.CharField(max_length=50)
# 文件保存路徑
path = models.CharField(max_length=100)
# 上傳時間
upload_time = models.DateTimeField(default=timezone.now)
然后，在項目根目錄下執(zhí)行下面 2 條命令，將模型結(jié)構(gòu)映射到數(shù)據(jù)庫中
# 數(shù)據(jù)庫映射
Python3 manage.py makemigrations
python3 manage.py migrate
2-4 自定義表單控件
在 index App 下創(chuàng)建一個表單文件 forms.py
在內(nèi)部自定義一個表單類，繼承于 forms.Form
# index App forms.py
from django import forms
class FileForm(forms.Form):
file = forms.FileField(
# 支持多文件上傳
widget=forms.ClearableFileInput(attrs={'multiple': True}),
label='請選擇文件',
)
2-5 添加上傳、下載路由 URL
為上傳、下載功能添加路由 URL
# 項目urls.py
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('index.urls'))
]
# index App urls.py
from django.urls import path
from .views import *
urlpatterns = [
# 上傳
path('', index_view, name='index'),
# 下載
path('download/<id>', download_view, name='download')
]
2-6 編寫模板文件
在 index App 的模板文件夾創(chuàng)建一個簡單的模板文件 upload.html
其中
form 代表視圖函數(shù)傳過來的表單實體對象
form.as_p 代表以字段格式渲染所有的表單元素
# index App upload.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>主頁-上傳文件</title>
</head>
<body>
<form method="post" enctype="multipart/form-data">
{% csrf_token %}
{{ form.as_p }}
<input type="submit" value="確定上傳">
</form>
</body>
</html>
2-7 上傳視圖函數(shù)
在 index App 下的 views.py 中編寫上傳功能的視圖函數(shù)
需要注意的是，我們需要提前在項目根目錄創(chuàng)建一個 upload 文件夾，用于存放上傳的文件
# index App views.py
def index_view(request):
"""
上傳文件
:param request:
:return:
"""
if request.method == 'POST':
form = FileForm(request.POST, request.FILES)
if form.is_valid():
# 選擇的文件
files = request.FILES.getlist('file')
# 遍歷寫入到數(shù)據(jù)庫中
for file in files:
# 寫入到數(shù)據(jù)庫中
file_model = FileModel(name=file.name, path=os.path.join('./upload', file.name))
file_model.save()
# 寫入到服務(wù)器本地
destination = open(os.path.join("./upload", file.name), 'wb+')
for chunk in file.chunks():
destination.write(chunk)
destination.close()
# 提示上傳成功
return HttpResponse('上傳成功!')
else:
form = FileForm()
return render(request, 'upload.html', locals())
2-8 下載視圖函數(shù)
接著，編寫下載功能的視圖函數(shù)
# index App views.py
def download_view(request, id):
"""
下載文件
:param request:
:param id:文件id
:return:
"""
file_result = FileModel.objects.filter(id=id)
# 如果文件存在，就下載文件
if file_result:
file = list(file_result)[0]
# 文件名稱及路徑
name = file.name
path = file.path
# 讀取文件
file = open(path, 'rb')
response = FileResponse(file)
# 使用urlquote對文件名稱進行編碼
response['Content-Disposition'] = 'attachment;filename="%s"' % urlquote(name)
return response
else:
return HttpResponse('文件不存在!')
2-9 運行并測試
運行項目，訪問下面的地址，并上傳一個文件
使用 Pycharm 打開 sqlite 數(shù)據(jù)庫，發(fā)現(xiàn)成功插入一條文件記錄，并且文件也上傳到 upload 文件夾下
接著訪問下面的地址實現(xiàn)文件下載功能「 其中，file_id 代表文件的 id 值 」
http://127.0.0.1:8000/download/file_id
3. 最后
文章通過一個簡單的例子實現(xiàn)了文件的上傳、下載功能，并同步文件記錄到數(shù)據(jù)庫
實際項目中，一般還包含文件列表、文件刪除等功能，這些功能只需要結(jié)合數(shù)據(jù)庫來增刪查改即可實現(xiàn)
我已經(jīng)將文中所有代碼上傳到公眾號后臺，后臺回復(fù)關(guān)鍵字「 upload 」獲取完整源碼
如果你覺得文章還不錯，請大家 點贊、分享、留言 下，因為這將是我持續(xù)輸出更多優(yōu)質(zhì)文章的最強動力！
