Django 如何實現文件上傳下載

1. 前言

大傢好,我是安果!

文件上傳、下載作為基礎功能,在 Web 項目中非常普遍,Django 項目如何實現文件上傳下載?

本篇文章將帶大傢 5 分鐘快速實現文件上傳下載功能

2. 實戰一下

詳細實現步驟如下( 9 步)

2-1  進入虛擬環境,創建一個項目及 App

workon django3

# 創建項目
django-admin startproject file_up_and_down_demo

# 進入項目根目錄
cd file_up_and_down_demo/

# 創建一個App
django-admin startapp index

2-2  創建模板目錄並配置 settings.py

在 index App 下創建一個 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  創建文件模型,並映射到數據庫

以默認的 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)

然後,在項目根目錄下執行下面 2 條命令,將模型結構映射到數據庫中

# 數據庫映射
Python3 manage.py makemigrations

python3 manage.py migrate

2-4  自定義表單控件

在 index App 下創建一個表單文件 forms.py

在內部自定義一個表單類,繼承於 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 的模板文件夾創建一個簡單的模板文件 upload.html

其中

  • form 代表視圖函數傳過來的表單實體對象
  • 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  上傳視圖函數

在 index App 下的 views.py 中編寫上傳功能的視圖函數

需要註意的是,我們需要提前在項目根目錄創建一個 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')

            # 遍歷寫入到數據庫中
            for file in files:
                # 寫入到數據庫中
                file_model = FileModel(name=file.name, path=os.path.join('./upload', file.name))
                file_model.save()

                # 寫入到服務器本地
                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  下載視圖函數

接著,編寫下載功能的視圖函數

# 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 數據庫,發現成功插入一條文件記錄,並且文件也上傳到 upload 文件夾下

接著訪問下面的地址實現文件下載功能「 其中,file_id 代表文件的 id 值 」

http://127.0.0.1:8000/download/file_id

3. 最後

文章通過一個簡單的例子實現瞭文件的上傳、下載功能,並同步文件記錄到數據庫

實際項目中,一般還包含文件列表、文件刪除等功能,這些功能隻需要結合數據庫來增刪查改即可實

代碼地址:https://github.com/xingag/python_web

以上就是Django 如何實現文件上傳下載的詳細內容,更多關於Django實現文件上傳下載的資料請關註WalkonNet其它相關文章!