当 Django 处理文件上传时，文件数据最终会被放置在 request.FILES （关于 request 对象的更多信息，请参见 request 和 response 对象 的文档）。本文档解释了文件如何存储在磁盘和内存中，以及如何自定义默认行为。
考虑一个包含 FileField 的表单：
forms.pyfrom django import forms\n\nclass UploadFileForm(forms.Form):\n title = forms.CharField(max_length=50)\n file = forms.FileField()\n处理这个表单的视图将在 request.FILES 中接收文件数据，它是一个字典，包含表单中每个 FileField （或 ImageField，或其他 FileField 子类）的键。所以上述表单中的数据将以 request.FILES['file'] 的形式被访问。
注意 request.FILES 只有当请求方法是 POST，至少有一个文件字段被实际发布，并且发布请求的 <form> 有 enctype="multipart/form-data" 属性时，才会包含数据。否则 request.FILES 将为空。
大多数情况下，你需要像 将上传的文件绑定到表单中 里描述的那样将文件数据从 request 传递给表单。示例如下：
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})\n注意我们必须将 request.FILES 传入到表单的\n构造方法中，只有这样文件数据才能绑定到表单中。
我们通常可能像这样处理上传文件：
\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)\n使用 UploadedFile.chunks() 而不是 read() 是为了确保即使是大文件又不会将我们系统的内存占满。
There are a few other methods and attributes available on UploadedFile\nobjects; see UploadedFile for a complete reference.
如果想要在 FileField 上的 Model 保存文件，使用 ModelForm 会让这一过程变得简单。当调用 form.save() 时，文件对象将会被保存在对相应 FileField 的 upload_to 参数所指定的地方：
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})\n如果你准备手工构建对象，你可以指定来自 request.FILES 的文件对象到模型里的文件对象：
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()\nIf you want to upload multiple files using one form field, create a subclass\nof the field's widget and set the allow_multiple_selected attribute on it\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\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()\n然后覆盖 FormView 子类的 post 方法来控制多个文件上传：
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 if form.is_valid():\n return self.form_valid(form)\n else:\n return self.form_invalid(form)\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()\n当一个用户上传文件时，Django 会把文件数据传递给 upload handler —— 这是一个很小的类，它用来在上传时处理文件数据。上传处理模块最初定义在 FILE_UPLOAD_HANDLERS 里，默认为：
["django.core.files.uploadhandler.MemoryFileUploadHandler",\n "django.core.files.uploadhandler.TemporaryFileUploadHandler"]\nMemoryFileUploadHandler 和 TemporaryFileUploadHandler 提供 Django 默认文件上传行为，小文件读入内存，大文件存在磁盘上。
你可以编写自定义的 handlers 来自定义 Django 如何处理文件。比如，你可以使用自定义的 handlers 来强制处理用户层面的配额，动态压缩数据，渲染进度条，甚至可以将数据发送到其他存储地址而不是本地。查看 编写自定义上传处理程序 来了解你如何自定义或者完全替换上传行为。
\n在保存上传的文件之前，数据需要保存到某处。
\n默认情况下，如果上传的文件小于2.5兆，Django 将把文件的所有内容保存到内存里。这意味着保存文件只涉及从内存中读取和写入磁盘，因此这很快。
\n但如果上传的文件很大，Django 会把文件写入系统临时目录的临时文件里存储。在类 Unix 平台里这意味着 Django 会生成一个类似名为 /tmp/tmpzfp6I6.upload 的文件。如果上传的文件非常大，你可以查看这个文件的大小增长，因为 Django 将数据流式传输到磁盘上。
2.5 megabytes; /tmp; 等这些细节只是合理的默认值，在下一节要介绍它们如何被自定义。
这里有一些控制 Django 文件上传行为的配置，请查看 File Upload Settings 。
\n有时候某些视图需要不同的上传行为。在这些例子里，你可以基于每个请求覆盖上传处理程序。默认情况下，这个列表将包含由 FILE_UPLOAD_HANDLERS 设置的上传处理程序，但你可以像修改其他列表一样修改这个列表。
比如，假设你正在编写 ProgressBarUploadHandler ，来提供在上传过程中的反馈给 Ajax widget。你需要添加这个处理程序到你的上传处理模块：
request.upload_handlers.insert(0, ProgressBarUploadHandler(request))\n你或许想在这里使用 list.insert() （而不是 append() ），因为进度条处理程序需要在其他处理程序之前使用。记住，上传处理程序是按顺序处理的。
如果你想完全替换上传处理程序，你需要指定新列表：
\nrequest.upload_handlers = [ProgressBarUploadHandler(request)]\n