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\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\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\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\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\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()\nSe você quer enviar múltiplos arquivos usando um campo de modelo, defina o atributo HTML ``multiple``do “widget” do campo:
\nforms.pyfrom django import forms\n\nclass FileFieldForm(forms.Form):\n file_field = forms.FileField(widget=forms.ClearableFileInput(attrs={'multiple': True}))\nE então sobreescreva o método post da sua subclasse de FormView para manipular o envio de múltiplos arquivos:
views.pyfrom django.views.generic.edit import FormView\nfrom .forms import FileFieldForm\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 post(self, request, *args, **kwargs):\n form_class = self.get_form_class()\n form = self.get_form(form_class)\n files = request.FILES.getlist('file_field')\n if form.is_valid():\n for f in files:\n ... # Do something with each file.\n return self.form_valid(form)\n else:\n return self.form_invalid(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:
["django.core.files.uploadhandler.MemoryFileUploadHandler",\n "django.core.files.uploadhandler.TemporaryFileUploadHandler"]\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))\nVocê provavelmente poderia querer usar o list.insert() neste caso (no lugar de append()) porque o manipulador de barra de progresso precisa rodar antes de qualquer outro. Lembre-se, os manipuladores de envio de arquivo são processados na ordem.
If you want to replace the upload handlers completely, you can assign a new\nlist:
\nrequest.upload_handlers = [ProgressBarUploadHandler(request)]\n