Django がファイルアップロードを扱うとき、ファイルデータは request.FILES に格納されます (request についての詳細は リクエスト/レスポンス オブジェクト を参照してください)。ここでは、ファイルがどのようにディスクとメモリに保管され、またどうやってデフォルトの動作を変更するかを説明します。
FileField を持つフォームを考えてみましょう:
forms.pyfrom django import forms\n\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 で、少なくとも1つのファイルフィールドが実際に投稿され、かつリクエストをポストした <form> の属性に enctype="multipart/form-data" が設定されていた場合に限られることに注意してください。そうでない場合には、request.FILES は空の辞書になります。
ほとんどの場合、Binding uploaded files to a form で説明されているように、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\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 をフォームのコンストラクタに渡す必要があることに注意してください。
アップロードされたファイルをハンドルする一般的な方法は、次のようになります。
\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)\nread() を使う代わりに UploadedFile.chunks() でループすることで、大きなサイズのファイルがアップロードされた時にメモリが専有されることを防げます。
UploadedFile オブジェクトには、他にもいくつかのメソッドと属性があります。完全なリファレンスについては、UploadedFile を読んでください。
FileField を持つ Model 上のファイルを保存するときは、ModelForm を使えば、このプロセスはとても簡単になります。この場合、ファイルオブジェクトは、form.save() を呼び出すだけで、対応する FileField の upload_to 引数で指定した場所に保存されます。
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})\n手動でオブジェクトを作成する場合には、request.FILES 内のファイルオブジェクトを、モデルの file_field 引数に指定します。
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})\nリクエストの外で手動でオブジェクトを構築する場合は、 FileField に File のようなオブジェクトを代入できます:
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()\n1つのフォームフィールドを使用して複数のファイルをアップロードしたい場合は、フォームのウィジットのサブクラスを作成し、allow_multiple_selected クラス属性を True に設定してください。
このようなファイルをすべてフォームで検証する (そしてフィールドの値にすべてを含める) ためには、 FileField をサブクラス化する必要があります。例を以下に示します。
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()\nそして、複数のアップロードファイルを扱うために、FormView サブクラスの form_valid() メソッドをオーバーライドします。
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)\nサイトのユーザがファイルをアップロードした時、Django はそのファイルのデータを アップロードハンドラ (upload handler) という、ファイルがアップロードされた時にデータをハンドリングするための小さなクラスへ渡します。アップロードハンドラは、初めに設定の FILE_UPLOAD_HANDLERS で定義されています。デフォルトでは次のようになっています。
[\n "django.core.files.uploadhandler.MemoryFileUploadHandler",\n "django.core.files.uploadhandler.TemporaryFileUploadHandler",\n]\nMemoryFileUploadHandler と TemporaryFileUploadHandler はともに、Django でファイルがアップロードされた時のデフォルトの動作（小さなファイルはメモリ上に保存し、大きなファイルはディスクに保存する）を提供しています。
カスタマイズハンドラを書けば、Django がファイルをハンドリングする方法をカスタマイズできます。たとえば、カスタムハンドラを使うことで、ユーザレベルでのクオータを設定したり、データをその場で圧縮したり、プログレスバーを表示したり、あるいは、送られたデータをローカルに保存せずに、別のストレージに転送することさえ可能です。ハンドラをカスタマイズしたり、アップロード時の動作を完全に置き換えたりする方法については、詳しくは Writing custom upload handlers を読んでください。
\nアップロードされたファイルを保存する時点で、そのデータはコンピュータ上のどこかに保存されているはずです。
\nデフォルトでは、アップロードファイルが 2.5 MB 未満ならば、Django はデータ全体をメモリ上に保持します。つまり、この場合にファイルを保存するというのは、メモリ上からデータを読み込んでディスクにファイルを書き込むだけなので、処理は短時間しかかかりません。
\nしかし、アップロードファイルのサイズが大きい場合、Django はアップロードファイルをシステムの一時ディレクトリ内に、一時ファイルとして保存します。Unix-like なプラットフォームなら、Django は /tmp/tmpzfp6I6.upload のようなファイルを作成すると考えて良いです。アップロードされたファイルが十分大きければ、Django がデータストリームをディスクに書き込むにつれ、このファイルのサイズが大きくなってゆくのを観察することができるでしょう。
これらの特定の設定（2.5 MB や /tmp ディレクトリなど）は、「常識的なデフォルト」として設定されているだけなので、次のセクションで説明するように、自分でカスタマイズできます。
Django のファイルアップロードの動作を制御するための設定がいくつかあります。詳しくは、 ファイルアップロードの設定 を参照してください。
\n時として特定のビューが異なるアップロード動作を必要とすることがあります。このような場合には、request.upload_handlers を修正することで、1リクエストごとに、アップロードハンドラをオーバーライドすることが可能です。デフォルトでは、このリストには FILE_UPLOAD_HANDLERS の設定で指定したアップロードハンドラが入っていますが、このリストは自由に修正できます。
たとえば、アップロードの進行状況を計算して、AJAX のウィジェットなどにフィードバックを返す ProgressBarUploadHandler というハンドラを作ったとしましょう。このハンドラを、次のようにアップロードハンドラのリストに追加します。
request.upload_handlers.insert(0, ProgressBarUploadHandler(request))\n上記のように list.insert() を使用すると、プログレスバーのハンドラーがリストの先頭に配置されることが保証されます。アップロードハンドラーは順番に実行されるため、この配置によりプログレスバーのハンドラーがデフォルトのハンドラーよりも先に実行され、アップロード全体の進行状況を追跡できるようになります。
アップロードハンドラ全体を置き換えたい場合は、新しいリストを代入します。
\nrequest.upload_handlers = [ProgressBarUploadHandler(request)]\n