---
title: "アップロードファイルとアップロードハンドラ"
version: 2.2
locale: ja
source: https://docs.djangoproject.com/ja/2.2/ref/files/uploads/
canonical: https://djangodocs.dev/ja/2.2/ref/files/uploads/
---
# アップロードファイルとアップロードハンドラ

## アップロードファイル

#### `class UploadedFile`

During file uploads, the actual file data is stored in [`request.FILES`](/ja/2.2/ref/request-response/#django.http.HttpRequest.FILES). Each entry in this dictionary is an
`UploadedFile` object (or a subclass) -- a simple wrapper around an uploaded
file. You'll usually use one of these methods to access the uploaded content:

#### `UploadedFile.read()`

Read the entire uploaded data from the file. Be careful with this method:
if the uploaded file is huge it can overwhelm your system if you try to
read it into memory. You'll probably want to use `chunks()` instead; see
below.

#### `UploadedFile.multiple_chunks(chunk_size=None)`

Returns `True` if the uploaded file is big enough to require reading in
multiple chunks. By default this will be any file larger than 2.5 megabytes,
but that's configurable; see below.

#### `UploadedFile.chunks(chunk_size=None)`

A generator returning chunks of the file. If `multiple_chunks()` is
`True`, you should use this method in a loop instead of `read()`.

In practice, it's often easiest simply to use `chunks()` all the time.
Looping over `chunks()` instead of using `read()` ensures that large
files don't overwhelm your system's memory.

Here are some useful attributes of `UploadedFile`:

#### `UploadedFile.name`

The name of the uploaded file (e.g. `my_file.txt`).

#### `UploadedFile.size`

The size, in bytes, of the uploaded file.

#### `UploadedFile.content_type`

The content-type header uploaded with the file (e.g. `text/plain`
or `application/pdf`). Like any data supplied by the user, you
shouldn't trust that the uploaded file is actually this type. You'll still
need to validate that the file contains the content that the content-type
header claims -- "trust but verify."

#### `UploadedFile.content_type_extra`

A dictionary containing extra parameters passed to the `content-type`
header. This is typically provided by services, such as Google App Engine,
that intercept and handle file uploads on your behalf. As a result your
handler may not receive the uploaded file content, but instead a URL or
other pointer to the file. (see [RFC 2388](https://www.ietf.org/rfc/rfc2388.txt) section 5.3).

#### `UploadedFile.charset`

For `text/*` content-types, the character set (i.e. `utf8`)
supplied by the browser. Again, "trust but verify" is the best policy here.

> **Note**
>
> Like regular Python files, you can read the file line-by-line simply by
> iterating over the uploaded file:
>
> ```python
> for line in uploadedfile:
>     do_something_with(line)
> ```
>
> Lines are split using [universal newlines](https://www.python.org/dev/peps/pep-0278). The following are recognized
> as ending a line: the Unix end-of-line convention `'\n'`, the Windows
> convention `'\r\n'`, and the old Macintosh convention `'\r'`.

Subclasses of `UploadedFile` include:

#### `class TemporaryUploadedFile`

A file uploaded to a temporary location (i.e. stream-to-disk). This class
is used by the
[`TemporaryFileUploadHandler`](#django.core.files.uploadhandler.TemporaryFileUploadHandler). In
addition to the methods from [`UploadedFile`](#django.core.files.uploadedfile.UploadedFile), it has one additional
method:

#### `TemporaryUploadedFile.temporary_file_path()`

Returns the full path to the temporary uploaded file.

#### `class InMemoryUploadedFile`

A file uploaded into memory (i.e. stream-to-memory). This class is used
by the [`MemoryFileUploadHandler`](#django.core.files.uploadhandler.MemoryFileUploadHandler).

## ビルトインのアップロードハンドラ

Together the [`MemoryFileUploadHandler`](#django.core.files.uploadhandler.MemoryFileUploadHandler) and
[`TemporaryFileUploadHandler`](#django.core.files.uploadhandler.TemporaryFileUploadHandler) provide Django's default file upload
behavior of reading small files into memory and large ones onto disk. They
are located in `django.core.files.uploadhandler`.

#### `class MemoryFileUploadHandler`

File upload handler to stream uploads into memory (used for small files).

#### `class TemporaryFileUploadHandler`

Upload handler that streams data into a temporary file using
[`TemporaryUploadedFile`](#django.core.files.uploadedfile.TemporaryUploadedFile).

## アップロードハンドラをカスタマイズする

#### `class FileUploadHandler`

全てのファイルアップロードハンドラは、`django.core.files.uploadhandler.FileUploadHandler` のサブクラスとなります。アップロードハンドラはいつでも好きなときに定義できます。

### 必要なメソッド

カスタマイズされたファイルアップロードハンドラでは、以下のメソッドを定義する **必要があります**。

#### `FileUploadHandler.receive_data_chunk(raw_data, start)`

ファイルアップロードから、データの "chunk" を受け取ります。

`raw_data` is a bytestring containing the uploaded data.

`start` はこの `raw_data` チャンクが始まる、ファイル内での位置です。

あなたが返すデータは、その後のアップロードハンドラの `receive_data_chunk` メソッドに渡されます。 この方法で、1 つのハンドラは他のハンドラの「フィルタ」になることができます。

`receive_data_chunk` から `None` を返し、残りのアップロードハンドラがこのチャンクを取得するのを短絡します。 これは、アップロードしたデータを自分で保存しておき、将来のハンドラでデータのコピーを保存したくない場合に便利です。

`StopUpload` または `SkipFile` 例外を発生させると、アップロードが中止されるか、ファイルが完全にスキップされます。

#### `FileUploadHandler.file_complete(file_size)`

ファイルのアップロードが完了したときに呼ばれます。

ハンドラは `request.FILES` に格納される `UploadedFile` オブジェクトを返します。 ハンドラは ``Upload`File`` オブジェクトが後続のアップロードハンドラから来るべきであることを示すために `None` を返すかもしれません。

### 省略可能なメソッド

独自のアップロードハンドラは、以下の省略可能なメソッドや属性を定義することができます:

#### `FileUploadHandler.chunk_size`

Django がメモリに格納してハンドラに送り込む "chunks" のサイズです (byte で表されます)。 つまり、この属性は `FileUploadHandler.receive_data_chunk` に渡されるチャンクのサイズをコントロールします。

パフォーマンスを最大限にするために、チャンクサイズは `4` で割り切れる必要があり、2 GB (2<sup>31</sup> bytes) を超えてはいけません。 複数のハンドラによってチャンクサイズが複数ある場合、Django はハンドラで定義された最小のチャンクサイズを使用します。

デフォルトは 64\*2<sup>10</sup> bytes、つまり 64 KB です。

#### `FileUploadHandler.new_file(field_name, file_name, content_type, content_length, charset, content_type_extra)`

新しいファイルのアップロード開始を通知するコールバックです。 アップロードハンドラにデータが送られる前に呼び出されます。

`field_name` は、ファイル `<input>` フィールドの文字列名です。

`file_name` is the filename provided by the browser.

`content_type` は、ブラウザによって提供される MIME タイプです -- 例: `'image/jpeg'`。

`content_length` は、ブラウザによって与えられる画像の長さです。提供されずに `None` となることがあります。

`charset` は、ブラウザによって与えられる文字セットです (例: `utf8`)。`content_length` のように、提供されないことがあります。

`content_type_extra` は、`content-type` からの、ファイルについての追加情報です。[`UploadedFile.content_type_extra`](#django.core.files.uploadedfile.UploadedFile.content_type_extra) をご覧ください。

このメソッドは、将来のハンドラがこのファイルをハンドリングするのを防ぐため、`StopFutureHandlers` 例外を投げます。

#### `FileUploadHandler.upload_complete()`

全てのアップロード (全てのファイル)  が完了したことを通知するコールバックです。

#### `FileUploadHandler.handle_raw_input(input_data, META, content_length, boundary, encoding)`

ハンドラに対して、生の HTTP インプットのパースを完全にオーバーライドできるようにします。

`input_data` は、`read()` をサポートするファイルのようなオブジェクトです。

`META` は、`request.META` と同じオブジェクトです。

`content_length` は、`input_data` 内のデータの長さです。```input_data` から ``content_length``` バイト以上を読み出さないでください。

`boundary` は、このリクエストの MIME

`encoding` は、リクエストのエンコーディングです。

アップロードハンドリングを継続したいとき、`None` を返します。もしくはリクエストに適した新しいデータ構造を直接返したいとき、 `(POST, FILES)` のタプルを返します。