$_FILES – PHPリファレンス

$_FILES

投稿日: 2012年5月21日作成者: alphasis

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

使い方
サンプル
1. ファイルサイズ制限

使い方

$_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
echo ‘<p>$_FILES[userFile][name]: ‘ . “{$_FILES[userFile][name]}</p>”; // name属性値が「userFile」のファイル送信欄に入力したしたファイルの名前を出力
echo ‘<p>$_FILES[userFile][type]: ‘ . “{$_FILES[userFile][type]}</p>”; // name属性値が「userFile」のファイル送信欄に入力したしたファイルのMIME型を出力
echo ‘<p>$_FILES[userFile][size]: ‘ . “{$_FILES[userFile][size]}</p>”; // name属性値が「userFile」のファイル送信欄に入力したしたファイルのサイズ（バイト単位）を出力
echo ‘<p>$_FILES[userFile][error]: ‘ . “{$_FILES[userFile][error]}</p>”; // ファイルアップロードに関するエラーコードを出力
?>

↓↓↓出力結果↓↓↓

$_FILES[userFile][name]: sample.txt
$_FILES[userFile][type]: text/plain
$_FILES[userFile][size]: 12345
$_FILES[userFile][error]: 0