array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'features.file-upload.multiple.php', 1 => '複数ファイルのアップロード', 2 => '複数ファイルのアップロード', ), 'up' => array ( 0 => 'features.file-upload.php', 1 => 'ファイルアップロードの処理', ), 'prev' => array ( 0 => 'features.file-upload.common-pitfalls.php', 1 => '陥りやすい落とし穴', ), 'next' => array ( 0 => 'features.file-upload.put-method.php', 1 => 'PUT メソッドのサポート', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'features/file-upload.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

複数ファイルのアップロード

input で異なった name を 使用することにより、複数のファイルをアップロードすることができます。

複数のファイルを一度にアップロードし、自動的にまとめられた情報を 配列で取得することが可能です。これを行うには、HTML フォームで 複数選択可能なセレクトやチェックボックスを指定する際と同様、 配列を用いた投稿用の構文を使用する必要があります。

例1 複数ファイルのアップロード

<form action="file-upload.php" method="post" enctype="multipart/form-data">
  Send these files:<br />
  <input name="userfile[]" type="file" /><br />
  <input name="userfile[]" type="file" /><br />
  <input type="submit" value="Send files" />
</form>

上記のフォームで投稿された場合、配列 $_FILES['userfile'], $_FILES['userfile']['name'], $_FILES['userfile']['size'] が設定されます。

例えば、ファイル名が /home/test/review.html および /home/test/xwp.out のファイルが 投稿されたとしましょう。この場合、 $_FILES['userfile']['name'][0] の値が review.html となり、 $_FILES['userfile']['name'][1] の値が xwp.out となります。 同様に、$_FILES['userfile']['size'][0] の値が review.html のファイルサイズといったように なります。

$_FILES['userfile']['name'][0], $_FILES['userfile']['tmp_name'][0], $_FILES['userfile']['size'][0], $_FILES['userfile']['type'][0] も設定されます。

警告

max_file_uploads は一回のリクエストあたりでアップロードできるファイルの数の制限値となります。 フォームからの一回のリクエストで、 これを超える数のファイルをアップロードしてしまわないようにしましょう。

例2 ディレクトリ全体をアップロードする

HTML のファイルアップロードフィールド中に、 webkitdirectory 属性を指定することで ディレクトリ全体をアップロードすることができます。 この機能はほとんどのモダンなブラウザでサポートされています。

full_path の情報を使うと、 相対パスを保存することもできますし、 サーバー上で同じディレクトリを再構築することもできます。 

<form action="file-upload.php" method="post" enctype="multipart/form-data">
  Send this directory:<br />
  <input name="userfile[]" type="file" webkitdirectory multiple />
  <input type="submit" value="Send files" />
</form>
警告

webkitdirectory 属性は標準ではありませんし、 標準化の過程にも入っていません。 この属性を Web 上の本番環境で使わないで下さい: なぜなら、この属性を全ユーザーが使えるとは限らないからです。 また、この属性はクライアントの実装に非互換がある可能性もありますし、 振る舞いが将来変更される可能性もあります。

PHP は ブラウザ/ユーザーエージェントから送られてきた相対パスの情報をパースし、 その情報を $_FILES 配列に渡すことだけを行います。 full_path 配列中の値が、 実際のディレクトリ構造を含んでいるという保証はありません。 よって、PHP アプリケーションはこの情報を信用してはいけません。