5 分钟,带你快速入门 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. 最后

文章通过一个简单的例子实现了文件的上传、下载功能,并同步文件记录到数据库

实际项目中,一般还包含文件列表、文件删除等功能,这些功能只需要结合数据库来增删查改即可实现

(0)

相关推荐

  • 分分钟教你Python Web开发框架Django

    大家好,我是辰哥! Python除了爬虫.深度学习(人工智能).数据分析等外,还可以用来开发网站系统,如我们常见的知乎,豆瓣等都是用Python开发的网站系统. 今天辰哥就来教大家如何新建属于自己的D ...

  • 第一个django应用--简单的 hello world 项目

    前提条件 python3 django==2.2 django安装请见:Django快速安装 注意:django项目更合适的是运行在虚拟环境下,不过我们这里只是学习hello world,为减少其他因 ...

  • 前端教程:DjangoAjax应用

    Ajax基本上是集成到一起,以减少页负载数量的技术的组合.我们通常使用Ajax来缓解的最终用户体验.在Django使用Ajax可以直接使用Ajax库如jQuery或其它来完成.比方说,想使用jQuer ...

  • python测试开发django-34.xadmin管理后台

    前言 django自带的admin后台管理页面有点丑陋,于是网上的大神优化了一版后台管理xadmin,并且开源了,在github开源下载到源码. 注意环境搭配: django  2.1.2 xadmi ...

  • 第 59 天:Python Django 模型概述与应用

    今天来为大家介绍 Django 框架的模型部分,模型是真实数据的简单明确的描述,它包含了储存的数据所必要的字段和行为,Django 遵循 DRY Principle .它的目标是你只需要定义数据模型, ...

  • Office 文件转 PDF 之服务实战

    来源:Python 技术「ID: pythonall」 小编之前写了一篇关于 Office 文件转 PDF 的实战文章,详见Python 小技之 Office 文件转 PDF但是在平时的工作中,咱们需 ...

  • JWT-配置与使用

    JWT-配置与使用

  • 5 分钟,带你快速入门 Django DRF

    5 分钟,带你快速入门 Django DRF

  • 10分钟带你快速入门JavaScript

    Javascript,从"最被误解的语言",最后神奇地转变成为"最流行的语言",证明它经受得起时间的考验.虽然单独来看,它的交互设计有些失败,但是加上Ajax的 ...

  • 仵航说 前后端分离,文件上传下载(springBoot+vue+elementUI)仵老大

    仵航说 前后端分离,文件上传下载(springBoot+vue+elementUI)仵老大

  • 一文教你实现java中的文件上传下载

    大家好,我是小编LRyab,公众号LRyab博客网,LRyab博客网是分享一些个人成长.思考方向.个人感悟.职业规划,博客涵盖java技术 vue. html. css.前端技术spring全家桶. ...

  • 做视频月入过万!不会剪辑怎么办?手把手3分钟带你剪辑入门

    近几年,视频爆火,不管是长视频和短视频,都很受欢迎,有太多的小白一跃成为大众名人,还顺便达到了月入过万的状态. 想做视频,就得学习后期剪辑.除了学校系统的学习,就是参加培训班,或者自学了.具体要怎么选 ...

  • 三分钟带你快速了解白茶

    茶农茶舍 教你品茶,识茶,泡茶,习茶道五境之美.喝好茶加微V信:1930402313 33篇原创内容 公众号 白茶是是汉族茶农创制的传统名茶,是我国的六大茶类之一,指一种采摘后不经杀青或揉捻,只经过晒 ...

  • 如何拍出印象派照片?5招带你快速入门!

    无论你是摄影菜鸟,还是摄影老手,相信随着时间的流逝,我们创作的热情和想象力也都将慢慢消耗殆尽,而最终那份对突破影像极限的原始冲动也将无处可寻. 因此,如何才能找到一种方式去保持激情,并且让创造力回流到 ...

  • 3分钟带你快速打通私域流量,抢先同行推动大促活动爆发

    分享不断诚意满满.大家好,我是大人物,你们的人物哥!又见面了! 期待了这么久的618终于来了,大家61的战绩如何?我操作的这家店爆发还算不错,一天有6W+访客50W+的销售额.不过优化调整不能松懈,后 ...

  • 90分钟带你快速掌握【屋面排水设计】

    屋面排水设计是施工图设计的重要组成部分之一,为了排除屋面雨水,需有周密的排水计划,包括:选择屋顶排水坡度.确定排水方式.进行屋顶排水组织设计. 今天给大家简单聊一聊屋面排水方式 ▽ 屋面排水方式主要有 ...