Django がファイルアップロードを扱うとき、ファイルデータは request.FILES に格納されます (request についての詳細は request and response objects をご覧ください)。ここでは、ファイルがどのようにディスクとメモリに保管され、またどうやってデフォルトの動作を変更するかを説明します。
Consider a form containing a FileField:
from 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'] でアクセスすることができます。
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:
from 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 をフォームのコンストラクタに渡す必要があることに注意してください。
アップロードされたファイルをハンドルする一般的な方法は、次のようになります。
\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\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})\n1 つのフォームフィールドで複数のファイルをアップロードしたい場合、フィールドのウィジェットの multiple HTML 属性をセットしてください:
from django import forms\n\nclass FileFieldForm(forms.Form):\n file_field = forms.FileField(widget=forms.ClearableFileInput(attrs={'multiple': True}))\nそして、複数のファイルアップロードを扱うために、あなたの FormView サブクラスの post メソッドをオーバーライドします:
from django.views.generic.edit import FormView\nfrom .forms import FileFieldForm\n\nclass FileFieldView(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)\nサイトのユーザがファイルをアップロードした時、Django はそのファイルのデータを アップロードハンドラ (upload handler) という、ファイルがアップロードされた時にデータをハンドリングするための小さなクラスへ渡します。アップロードハンドラは、初めに設定の FILE_UPLOAD_HANDLERS で定義されています。デフォルトでは次のようになっています。
["django.core.files.uploadhandler.MemoryFileUploadHandler",\n "django.core.files.uploadhandler.TemporaryFileUploadHandler"]\nMemoryFileUploadHandler と TemporaryFileUploadHandler はともに、Django でファイルがアップロードされた時のデフォルトの動作――小さなファイルはメモリ上に保存し、大きなファイルはディスクに保存する――を提供しています。
カスタマイズハンドラを書けば、Django がファイルをハンドリングする方法をカスタマイズすることができます。たとえば、カスタムハンドラを使うことで、ユーザレベルでのクオータを設定したり、データをその場で圧縮したり、プログレスバーを表示したり、あるいは、送られたデータをローカルに保存せずに、別のストレージに転送することさえ可能です。ハンドラをカスタマイズしたり、アップロード時の動作を完全に置き換えたりする方法については、詳しくは アップロードハンドラをカスタマイズする を読んでください。
\nアップロードされたファイルを保存する時点で、そのデータはコンピュータ上のどこかに保存されているはずです。
\nデフォルトでは、アップロードファイルが 2.5 MB 未満ならば、Django はデータ全体をメモリ上に保持します。つまり、この場合にファイルを保存するというのは、メモリ上からデータを読み込んでディスクにファイルを書き込むだけなので、処理は短時間しかかかりません。
\nしかし、アップロードファイルのサイズが大きい場合、Django はアップロードファイルをシステムの一時ディレクトリ内に、一時ファイルとして保存します。Unix-like なプラットフォームなら、Django は /tmp/tmpzfp6I6.upload のようなファイルを作成すると考えて良いです。アップロードされたファイルが十分大きければ、Django がデータストリームをディスクに書き込むにつれ、このファイルのサイズが大きくなってゆくのを観察することができるでしょう。
These specifics -- 2.5 megabytes; /tmp; etc. -- are "reasonable defaults"\nwhich can be customized as described in the next section.
Django のファイルアップロードの動作を制御するための設定がいくつかあります。詳しくは、 File Upload Settings を参照してください。
\n時として特定のビューが異なるアップロード動作を必要とすることがあります。このような場合には、request.upload_handlers を修正することで、1リクエストごとに、アップロードハンドラをオーバーライドすることが可能です。デフォルトでは、このリストには FILE_UPLOAD_HANDLERS の設定で指定したアップロードハンドラが入っていますが、このリストは自由に修正することができます。
たとえば、アップロードの進行状況を計算して、AJAX のウィジェットなどにフィードバックを返す ProgressBarUploadHandler というハンドラを作ったとしましょう。このハンドラを、次のようにアップロードハンドラのリストに追加します。
request.upload_handlers.insert(0, ProgressBarUploadHandler(request))\nこの場合には、list.append() メソッドの代わりに list.insert() を使ったほうが良いでしょう。なぜなら、プログレスバーハンドラーは、他のハンドラの 前に 実行する必要があるでしょうから。アップロードハンドラは、リストの前から順に処理されることに注意してください。
If you want to replace the upload handlers completely, you can assign a new\nlist:
\nrequest.upload_handlers = [ProgressBarUploadHandler(request)]\n