django文件上传

当django处理文件上传时,文件数据被打包封装在request.FILES中

1、基本文件上传

首先写一个form表单,它必须包含一个FileField文件字段:

#forms.py

from django import forms

class UploadFileForm(forms.Form):
    title = forms.CharField(max_length=50)
    file = forms.FileField()

处理这个表单的视图将在request.FILES中收到文件数据,可以用request.FILES['file']来获取上传文件的具体数据,其中的键值'file'是根据form表单中字段file=forms.FileField()的变量名来的

注意:request.FILES只有在请求方法为POST,并且提交请求的<form>具有enctype="multipart/form-data"属性时才有效,否则request.FILES将为空

下面是一个接收上传文件的视图范例:

#views.py

from django.http import HttpResponse
from django.shortcuts import render
from .forms import UploadFileForm
from django.conf import settings

#创建函数处理上传文件数据
def handle_uploaded_file(f,filename):
    filename_path = f'{settings.MEDIA_ROOT}{filename}'  #生成文件名及路径
    with open(filename_path,'wb+') as destination:
        for chunk in f.chunks():
            destination.write(chunk)
        destination.close()

def index(request):
    if request.method == 'POST':
        forms = UploadFileForm(request.POST,request.FILES)
        if forms.is_valid():
            handle_uploaded_file(request.FILES['file'],filename=request.FILES.get('file'))
            return HttpResponse('file for upload ok')
        print(forms)

    else:
        forms = UploadFileForm()
        print(forms)
    return render(request,'index.html',context={'forms':forms})

在文件上传期间,实际文件数据存储在request.FILES,此字典中的每个条目都是一个UploadedFile对象,此对象包括以下方法和属性:

UploadedFile.read():从文件中读取整个上传的数据,小心这个方法,如果上传的文件太大,如果你试图将它读入内存,它会消耗系统大量内存,你可以使用cunks()方法

UploadedFile.multipls_chunks(chunk_size=None):如果上传的文件足够大,需要在多个块中读取,则返回True,默认为True,默认chunk_size为2.5M,也可以指定

 UploadedFile.chunks(chunk_size=None):生成器返回文件的块,如果multiple_chunks()为True,则因该尽量使用此方法而不是read()方法,在实践中通常最简单的方法就是一直使用chunks(),通过循环chunks()来存储文件数据

UploadedFile长用的一些属性:

UploadedFile.name:上传文件的名称

UploadedFile.size:上传文件大小

UploadedFile.content_type:随文件一起上传的内容类型标题(如:text/plain或application/pdf)

UploadedFile.content_type_extra:包含传递给content-type标头的额外参数的字典

UploadedFile.charset:队友text/content-types提供的utf8字符集编码

其它文件代码:

#urls.py
from django.contrib import admin
from django.urls import path,re_path
from testfileile import views

urlpatterns = [
    path('admin/', admin.site.urls),
    re_path(r'^$',views.index,name='index'),


#settings.py配置媒体文件上传目录和访问路径
MEDIA_ROOT = os.path.join(BASE_DIR,'static/images/')
MEDIA_URL = '/media/'

#index.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>index</title>
</head>
<body>
<form method="post" action="/" enctype="multipart/form-data"> #上传文件时必须包含enctype属性
    {% csrf_token %}
    {{ forms }}<br>
    <input type="submit" value="提交">
</form>
</body>
</html>

2、使用模型处理上传的文件

如果是通过模型层的model来指定上传文件的保存方式,使用ModelForm更方便,调用form.save()的时候,文件对象会保存在相应的FileField的upload_to参数指定的地方,实际文件会存储在settings配置文件中MEDIA_ROOT指定的绝对路径加upload_to子目录下

看如下示例:

#models.py

from django.db import models


class ModelFileField(models.Model):
    title = models.CharField(max_length=200)
    file = models.FileField(upload_to='photos/%Y/%m/%d') #将格式化为时间目录

#froms.py通过模型创建表单

from .models import ModelFileField
from django.forms import ModelForm

class ModelFormFile(ModelForm):
    class Meta:
        model = ModelFileField
        fields = "__all__"

#views.py

from django.http import HttpResponse
from django.shortcuts import render
from .forms import ModelFormFile

def upload_file(request):
    if request.method == 'POST':
        forms = ModelFormFile(request.POST,request.FILES)
        if forms.is_valid():
            forms.save(commit=True) #文件直接保存在model中的upload_to指定的子目录下
            return HttpResponse('ok')
    else:
        forms = ModelFormFile()
    return render(request,'upload.html',{'forms':forms})

#settings.py
MEDIA_ROOT = os.path.join(BASE_DIR,'static/images/')
MEDIA_URL = '/media/'

#upload.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>upload file</title>
</head>
<body>
<form method="post" action="{% url 'upload' %}" enctype="multipart/form-data">
    {% csrf_token %}
    {{ forms }}<br>
    <input type="submit" value="提交">
</form>
</body>
</html>

如果要手动指定对象,只需将文件对象request.FILES赋值给模型中的文件字段即可:

但需要注意,如有其它字段必须允许为空,否则将引发异常!

#views.py

from django.http import HttpResponse
from django.shortcuts import render
from .forms import ModelFormFile
from .models import ModelFileField

def upload_file(request):
    if request.method == 'POST':
        forms = ModelFormFile(request.POST,request.FILES)
        if forms.is_valid():
            instance = ModelFileField(file=request.FILES['file']) #将文件数据指定到模型字段
            instance.save()
            #forms.save(commit=True)
            return HttpResponse('ok')
    else:
        forms = ModelFormFile()
    return render(request,'upload.html',{'forms':forms})

3、同时上传多个文件

如果要使用一个表单字段同时上传多个文件,需设置字段HTML标签的mulpiple属性为True,在django表单中设置小部件HTML的属性:

#forms.py

from django import forms
from .models import ModelFileField
from django.forms import ModelForm

class ModelFormFile(ModelForm):
    class Meta:
        model = ModelFileField
        fields = "__all__"
        widgets = {
            'file':forms.ClearableFileInput(attrs={'multiple':True})
        } #上面模型的基础上,创建的forms表单添加HTML属性multiple

在视图中存储多个文件则需要通过getlist方法获取多个文件的列表,然后循环存储到数据并保存即可:

#views.py

from django.http import HttpResponse
from django.shortcuts import render
from .forms import ModelFormFile
from .models import ModelFileField

def upload_file(request):
    if request.method == 'POST':
        forms = ModelFormFile(request.POST,request.FILES)
        if forms.is_valid():
            for i in request.FILES.getlist('file'): #获取文件列表
                instance = ModelFileField(file=i)
                instance.save()
            return HttpResponse('ok')
    else:
        forms = ModelFormFile()
    return render(request,'upload.html',{'forms':forms})

4、上传文件处理器

当用户上传一个文件的时候,Django会把文件数据传递给上传文件处理器一个类。

上传处理器的配置定义在FILE_UPLOAD_HANDLERS中,默认为:

["django.core.files.uploadhandler.MemoryFileUploadHandler", "django.core.files.uploadhandler.TemporaryFileUploadHandler"]

MemoryFileUploadHandler和TemporaryFileUploadHandler定义了Django的默认文件上传行为:将小文件读取到内存中,大文件放置在磁盘中。

在你保存上传文件之前,数据需要储存在某个地方。通常,如果上传文件小于2.5MB,Django会把整个内容存到内存。 这意味着,文件的保存仅仅涉及到内存中的读取和磁盘的写入,所以非常快。但是,如果上传的文件很大,Django会把它写入一个临时文件,储存在你的系统临时目录中。在类Unix的平台下,Django会生成一个文件,名称类似于/tmp/tmpzfp6I6.upload。

我们可以编写自定义的处理器,来定制Django如何处理文件。例如,根据级别不同限制用户的磁盘配额,在运行中压缩数据,渲染进度条,甚至是转存到另一个储存位置,而不把它存到本地。

 

posted @ 2019-05-09 22:29  Py.qi  阅读(2109)  评论(1编辑  收藏  举报