$_FILESは、定義済み変数のひとつで、POSTメソッドでアップロードしたファイルの情報を格納した多次元配列となっている。

使い方

$_FILESは、二次元配列になっているので、２つのキーで呼び出す。１つ目のキーは、フォーム部品のファイル送信欄のname属性値。２つ目のキーは、name、type、size、tmp_name、errorのいづれか。

例えば、ファイル送信欄のname属性値がuserFileであれば、userFileを１つ目のキーにする。ファイル名を呼び出すのであれば、２つ目のキーを「name」にし、$_FILES['userFile']['name']となる。

$_FILES[‘userFile’][‘name’]

ファイルの名前。

$_FILES[‘userFile’][‘type’]

ファイルのMIME型。

$_FILES[‘userFile’][‘size’]

ファイルのサイズ（バイト単位）。

$_FILES[‘userFile’][‘tmp_name’]

テンポラリファイル名。

$_FILES[‘userFile’][‘error’]

ファイルアップロードに関するエラーコード。

• 0: エラーなし。ファイルアップロード成功。
• 1: ファイルサイズが、「php.ini」の「upload_max_filesize」の値を超えている。
• 2: ファイルサイズが、送信フォームで指定した「MAX_FILE_SIZE」の値を超えている。
• 3: 一部しかアップロードされなかった。
• 4: アップロードされなかった。
• 6: テンポラリフォルダがない。
• 7: ディスクへの書き込みに失敗。
• 8: PHP拡張モジュールがファイルアップロードを中止。

$_FILESは、スーパーグローバル変数で、プログラム全体の、どのスコープでも呼び出せる。関数の内部で呼び出す場合、グローバル変数は、グローバル宣言するが、スーパーグローバル変数は、グローバル宣言すら必要ない。

サンプル

「sample.txt」というテキストファイルを送信すると、

↓↓↓出力結果↓↓↓

ファイルサイズ制限

PHPで取得可能なファイルの最大サイズを指定する方法。

サイズが「12345」の「sample.txt」というテキストファイルを送信すると、

↓↓↓出力結果↓↓↓

エラーコード「2」は、送信フォームで指定した「MAX_FILE_SIZE」をオーバーしていることによるエラーを示している。