軽量PHPフレームワーク 'CodeIgniter' 徹底ガイド！

　「CI_Upload」ライブラリクラスは、クライアントからアップロードされるファイルを受け取り、
ファイルシステムに保存する機能を提供します。

　PHPにはスーパーグローバル変数「$_FILES」がありますが、CodeIgniterでWebアプリケーションを
開発する際は、「$_FILES」変数は使わず、「CI_Upload」ライブラリクラスを使います。

　「CI_Upload」クラスには以下の設定項目があります。
　「CI_Upload」をロードする際に指定するか、「application/config/upload.php」設定ファイルで設定します。

　「CI_Loader」クラスの「library()」メソッドで「CI_Upload」クラスをロードします。
「application/config/upload.php」の設定を利用せず、第二引数に設定連想配列を指定することもできます。

$this->load->library('upload');
$config = array(
    'upload_path' => '../tmp',
    'overwrite' => TRUE,
    'allowd_types' => '*',
);
$this->load->library('upload', $config);

　「CI_Upload」ライブラリクラスは、以下のようなHTMLの「FORM」から送信されたファイルを処理します。

<form action="/file/upload/" method="post" accept-charset="utf-8" enctype="multipart/form-data">
  <input type="file" name="userfile" />
  <input type="submit" value="送信" />
</form>

do_upload($field = 'userfile')

　HTMLの「FORM」から送信されたファイルをファイルシステムに保存します。
　引数にはFORMの「<input type="file" name="userfile">」タグで指定した「name=」属性の値(文字列)を指定します。 　デフォルトは「userfile」となっているため、「name=」属性を「userfile」とした場合は引数は不要です。

$this->load->library('upload');
if ($this->upload->do_upload('my_file_name')) {
    $this->load->view('upload_success');
}
else {
    $this->load->view('upload_form');
}

data()

　アップロードされたファイルのファイル情報を連想配列で返します。

$config = array(
    'file_name' => 'sample.jpg';
    'upload_path' => '/tmp';
    'allowed_types' => '*';
);
$this->load->library('upload', $config);
if ($this->upload->do_upload()) {
    $file_info = $this->upload->data();
    print_r($file_info);
}
/*
Array
(
    [file_name] => sample.jpg
    [file_type] => image/jpeg
    [file_path] => /tmp/
    [full_path] => /tmp/sample.jpg
    [raw_name] => sample
    [orig_name] => sample.jpg
    [client_naem] => UserSent.jpg
    [file_ext] => .jpg
    [file_size] => 548.12
    [is_image] => 1
    [image_width] => 1024
    [image_height] => 768
    [image_type] => jpeg
    [image_size_str] => width="1024" height="768"
)
*/

　参照できるファイル情報には以下のものがあります。

display_errors($open = '<p>', $close = '</p>')

　「do_upload()」メソッドは、エラーが発生するとエラー情報をインスタンス変数に保持します。
　そのエラーメッセージを「display_errors()」メソッドで取得できます。

　第一引数にエラーメッセージの先頭に付加する文字列を、第二引数にエラーメッセージの末尾に付加する文字列を指定します。
　デフォルトは、「<p>」と「</p>」です。

$this->load->library('upload');
if ($this->upload->do_upload()) {
    $this->load->view('upload_success');
}
else {
    $msg = $this->upload->display_errors(' <p style="color:red;">', '</p>');
    $data['error_msg'] = $msg
    $this->load->view('upload_form', $data);
}



• upload_form.php
<?php echo $error_msg; ?>
<form action="/file/upload/" method="post" accept-charset="utf-8" enctype="multipart/form-data">
  <input type="file" name="userfile" /><br>
  <input type="submit" value="送信" />
</form>


• ブラウザ上の描画

The filetype you are attempting to upload is not allowed.

　「CI_Upload」で利用されるエラーメッセージはデフォルトでは
「system/language/english/upload_lang.php」に英語で定義されています。
　日本語など多言語化対応するには「system/language/english/upload_lang.php」を 「application/language/言語サブディレクトリ/」にコピーして編集します。

$ cp system/language/english/upload_lang.php application/language/japanese/