Отправка файлов ¶

Загрузка файлов, связанных с моделью ¶

Если вы сохраняете файл в Model содержащем поле FileField , использование формы ModelForm упрощает процесс. Файловый объект будет сохранен в месте, указанном параметром соответствующего upload_to поля FileField при вызове form.save() :

from django.http import HttpResponseRedirect
from django.shortcuts import render
from .forms import ModelFormWithFileField

def upload_file(request):
    if request.method == 'POST':
        form = ModelFormWithFileField(request.POST, request.FILES)
        if form.is_valid():
            # file is saved
            form.save()
            return HttpResponseRedirect('/success/url/')
    else:
        form = ModelFormWithFileField()
    return render(request, 'upload.html', {'form': form})

Если вы создаете объект вручную, вы можете назначить файл из объекта request.FILES полю файла модели:

from django.http import HttpResponseRedirect
from django.shortcuts import render
from .forms import UploadFileForm
from .models import ModelWithFileField

def upload_file(request):
    if request.method == 'POST':
        form = UploadFileForm(request.POST, request.FILES)
        if form.is_valid():
            instance = ModelWithFileField(file_field=request.FILES['file'])
            instance.save()
            return HttpResponseRedirect('/success/url/')
    else:
        form = UploadFileForm()
    return render(request, 'upload.html', {'form': form})

Загрузка нескольких файлов ¶

Если вы хотите разрешить загрузку нескольких файлов с использованием одного поля формы, установите атрибут HTML multiple компонента поля:

from django import forms

class FileFieldForm(forms.Form):
    file_field = forms.FileField(widget=forms.ClearableFileInput(attrs={'multiple': True}))

Затем переопределите post метод вашего подкласса, FormView чтобы иметь возможность обрабатывать несколько полученных файлов:

from django.views.generic.edit import FormView
from .forms import FileFieldForm

class FileFieldView(FormView):
    form_class = FileFieldForm
    template_name = 'upload.html'  # Replace with your template.
    success_url = '...'  # Replace with your URL or reverse().

    def post(self, request, *args, **kwargs):
        form_class = self.get_form_class()
        form = self.get_form(form_class)
        files = request.FILES.getlist('file_field')
        if form.is_valid():
            for f in files:
                ...  # Do something with each file.
            return self.form_valid(form)
        else:
            return self.form_invalid(form)

Место хранения данных ¶

Перед сохранением загруженных файлов данные необходимо где-то сохранить.

По умолчанию, если загруженный файл меньше 2,5 МБ, Django помещает весь файл в память. Это означает, что сохранение файла представляет собой простое чтение в память и запись на диск, что происходит очень быстро.

Однако, если загруженный файл слишком велик, Django записывает файл во временный файл, хранящийся в каталоге временных файлов системы. На Unix-подобной платформе Django обычно генерирует файл с путем, например /tmp/tmpzfp6I6.upload . Если файл достаточно велик, вы можете даже увидеть увеличение размера файла, поскольку он записывается в потоке на диск.

Эти конкретные параметры, 2,5 МБ /tmp и т. Д. являются просто «разумными» значениями по умолчанию, которые можно настроить, как описано в следующем разделе.

Модификация управления загрузкой ¶

Есть некоторые настройки для управления поведением загрузки файлов Django. См. Подробности в разделе « Настройки загрузки файлов» .

Редактирование обработчиков загрузки на лету ¶

Иногда для некоторых представлений требуется другое поведение при загрузке. В этих ситуациях можно переопределить обработчики загрузки для каждого запроса, изменив request.upload_handlers . По умолчанию этот список содержит перечисленные менеджеры загрузки FILE_UPLOAD_HANDLERS , но этот список можно редактировать, как и любой другой список.

Например, предположим, что вы написали обработчик, ProgressBarUploadHandler который возвращает информацию о ходе загрузки из некоторого компонента AJAX. Вот как добавить этот обработчик в список обработчиков загрузки:

request.upload_handlers.insert(0, ProgressBarUploadHandler(request))

В этом случае это list.insert() может быть более подходящим, чем append() потому, что менеджер индикатора выполнения должен запускаться раньше любого другого менеджера. Помните, что обработчики загрузки вызываются по порядку.

Если вы хотите полностью заменить менеджеры загрузки, просто назначьте новый список:

request.upload_handlers = [ProgressBarUploadHandler(request)]

from django.views.decorators.csrf import csrf_exempt, csrf_protect

@csrf_exempt
def upload_file_view(request):
    request.upload_handlers.insert(0, ProgressBarUploadHandler(request))
    return _upload_file_view(request)

@csrf_protect
def _upload_file_view(request):
    ... # Process request