Quando o Django lida com o upload de arquivos, o arquivo de dados termina sendo colocado em request.FILES (para mais sobre o objeto request veja a documentação sobre objetos de requisição e resposta). Este documento explica como arquivos são armazenados no disco ou na memória, e como personalizar o comportamento padrão.
Consider a form containing a FileField:
forms.pyfrom django import forms\n\n\nclass UploadFileForm(forms.Form):\n title = forms.CharField(max_length=50)\n file = forms.FileField()\nUma “view” que lida com este formulário irá receber o arquivo em request.FILES, o qual é um dicionário contendo uma chave para cada FileField (ou ImageField, ou outra subclasse de FileField) no formulário. Tal que os dados vindos do formulário acima devem estar acessíveis como request.FILES['file'].
Note that request.FILES will only\ncontain data if the request method was POST, at least one file field was\nactually posted, and the <form> that posted the request has the attribute\nenctype="multipart/form-data". Otherwise, request.FILES will be empty.
Most of the time, you’ll pass the file data from request into the form as\ndescribed in Binding uploaded files to a form. This would look something like:
views.pyfrom django.http import HttpResponseRedirect\nfrom django.shortcuts import render\nfrom .forms import UploadFileForm\n\n# Imaginary function to handle an uploaded file.\nfrom somewhere import handle_uploaded_file\n\n\ndef upload_file(request):\n if request.method == "POST":\n form = UploadFileForm(request.POST, request.FILES)\n if form.is_valid():\n handle_uploaded_file(request.FILES["file"])\n return HttpResponseRedirect("/success/url/")\n else:\n form = UploadFileForm()\n return render(request, "upload.html", {"form": form})\nNote que temos que passar request.FILES para o construtor do “form”; é assim que os dados do arquivo entra no form.
Aqui uma maneira comum que você talvez lide com o “upload” de arquivo:
\ndef handle_uploaded_file(f):\n with open("some/file/name.txt", "wb+") as destination:\n for chunk in f.chunks():\n destination.write(chunk)\nFazendo “loops” sobre UploadedFile.chunks() ao invés de usar o read() garante que grandes arquivos não vão forçar a memória do seu sistema.
Existem alguns outros métodos e atributos disponíveis nos objetos UploadedFile; veja a UploadedFile para uma completa referência.
Se você está usando um arquivo em uma Model com uma FileField, usando uma ModelForm faz este processo bem mais fácil. O objeto arquivo será salvo em um local especificado pelo argumento upload_to do FileField correspondente quando chamar form.save():
from django.http import HttpResponseRedirect\nfrom django.shortcuts import render\nfrom .forms import ModelFormWithFileField\n\n\ndef upload_file(request):\n if request.method == "POST":\n form = ModelFormWithFileField(request.POST, request.FILES)\n if form.is_valid():\n # file is saved\n form.save()\n return HttpResponseRedirect("/success/url/")\n else:\n form = ModelFormWithFileField()\n return render(request, "upload.html", {"form": form})\nIf you are constructing an object manually, you can assign the file object from\nrequest.FILES to the file field in the\nmodel:
from django.http import HttpResponseRedirect\nfrom django.shortcuts import render\nfrom .forms import UploadFileForm\nfrom .models import ModelWithFileField\n\n\ndef upload_file(request):\n if request.method == "POST":\n form = UploadFileForm(request.POST, request.FILES)\n if form.is_valid():\n instance = ModelWithFileField(file_field=request.FILES["file"])\n instance.save()\n return HttpResponseRedirect("/success/url/")\n else:\n form = UploadFileForm()\n return render(request, "upload.html", {"form": form})\nIf you are constructing an object manually outside of a request, you can assign\na File like object to the\nFileField:
from django.core.management.base import BaseCommand\nfrom django.core.files.base import ContentFile\n\n\nclass MyCommand(BaseCommand):\n def handle(self, *args, **options):\n content_file = ContentFile(b"Hello world!", name="hello-world.txt")\n instance = ModelWithFileField(file_field=content_file)\n instance.save()\nIf you want to upload multiple files using one form field, create a subclass\nof the field’s widget and set its allow_multiple_selected class attribute\nto True.
In order for such files to be all validated by your form (and have the value of\nthe field include them all), you will also have to subclass FileField. See\nbelow for an example.
forms.pyfrom django import forms\n\n\nclass MultipleFileInput(forms.ClearableFileInput):\n allow_multiple_selected = True\n\n\nclass MultipleFileField(forms.FileField):\n def __init__(self, *args, **kwargs):\n kwargs.setdefault("widget", MultipleFileInput())\n super().__init__(*args, **kwargs)\n\n def clean(self, data, initial=None):\n single_file_clean = super().clean\n if isinstance(data, (list, tuple)):\n result = [single_file_clean(d, initial) for d in data]\n else:\n result = [single_file_clean(data, initial)]\n return result\n\n\nclass FileFieldForm(forms.Form):\n file_field = MultipleFileField()\nThen override the form_valid() method of your\nFormView subclass to handle multiple file\nuploads:
views.pyfrom django.views.generic.edit import FormView\nfrom .forms import FileFieldForm\n\n\nclass FileFieldFormView(FormView):\n form_class = FileFieldForm\n template_name = "upload.html" # Replace with your template.\n success_url = "..." # Replace with your URL or reverse().\n\n def form_valid(self, form):\n files = form.cleaned_data["file_field"]\n for f in files:\n ... # Do something with each file.\n return super().form_valid(form)\nQuando um usuário envia um arquivo, o Django passa os dados do arquivo para um * manipular de envio de arquivo* – uma pequena classe que lida com dados de arquivos enquanto este é enviado. Manipuladores de envio de arquivo não inicialmente definidos na definição FILE_UPLOAD_HANDLERS o qual tem como padrão:
[\n "django.core.files.uploadhandler.MemoryFileUploadHandler",\n "django.core.files.uploadhandler.TemporaryFileUploadHandler",\n]\nJuntos as classes class:MemoryFileUploadHandler e TemporaryFileUploadHandler fornecem ao Django um comportamento padrão para o envio de arquivos que lê arquios pequenos na memória e grandes arquivos no disco.
Você pode escrever manipuladores que personalizem a maneira como Django lida com arquivos. Você pode por exemplo, usar manipuladores personalizados para forçar quotas no nível do usuário, comprimir dados enquanto chegam, renderizar barras de progresso, e mesmo enviar dados diretamente para um outro local de armazenamento sem armazenar localmente. Para maiores detalhes veja o Writing custom upload handlers para saber como você pode personalizar ou mudar completamente o comportamento do envio.
\nAntes que você salve os arquivos enviados, os dados precisam ser salvos em algum lugar.
\nPor padrão, se um arquivo enviado é menor que 2.5 megabytes, o Django irá manter todo o conteúdo do arquivo em memória. Isso significa que salvar o arquivo envolve somente uma leitura na memória e uma escrita no disco e portanto muito rápido.
\nPorém, se o arquivo enviado é muito grande, o Django irá escrever o arquivo enviado em um arquivo temporário no diretório de arquivos temporários do seu sistema. Em uma plataforma Unix isso significa que você pode esperar que o Django crie um arquivo cujo o nome seja algo como /tmp/tmpzfp6I6.upload`. Se o arquivo enviado é grande o bastante, você pode assistir o arquivo crescer em tamanho enquanto o Django transmite o dado para o disco.
\nThese specifics – 2.5 megabytes; /tmp; etc. – are “reasonable defaults”\nwhich can be customized as described in the next section.
Existem algumas definições que controla como o manipulador de envio de arquivo do Django se comporta. Para detalhes veja o Definições de envio de arquivos.
\nAs vezes uma “view” em particular requer um comportamento diferente para o envio de arquivos. Neste caso, você pode sobrescrever um manipulador baseado no “request” modificando o request.upload_handlers. Por padrão, esta lista contém os manipuladores informados pelo FILE_UPLOAD_HANDLERS, mas você pode modificar essa lista como qualquer outra lista.
Por exemplo, suponha que você tenha escrito um ProgressBarUploadHandler que dá um retorno sobre o progresso do envio do arquivo para algum tipo de “widget” AJAX. Você adicionaria este manipulador a sua lista de manipuladores como aqui:
request.upload_handlers.insert(0, ProgressBarUploadHandler(request))\nUsing list.insert(), as shown above, ensures that the progress bar handler\nis placed at the beginning of the list. Since upload handlers are executed in\norder, this placement guarantees that the progress bar handler runs before the\ndefault handlers, allowing it to track progress across the entire upload.
If you want to replace the upload handlers completely, you can assign a new\nlist:
\nrequest.upload_handlers = [ProgressBarUploadHandler(request)]\n