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

　PHPモジュールの「GD/GD2」を利用して、JPEG、GIF、PNG画像のリサイズや、切り抜き、回転・反転、 合成といった画像処理を行うことができます。

　「GD/GD2」モジュールを利用せずに、「ImageMagick」または、「NetPBM」画像処理ライブラリを利用して 画像のリサイズ、切り抜き、回転・反転を行うことも可能です。　(画像の合成はできません。)

　「CI_Loader」クラスの「library()」メソッドで「CI_Image_lib」 クラスをロードします。

$this->load->library('image_lib');

　「CI_Image_lib」ライブラリクラスのロード時に設定情報を指定することも可能です。

$this->load->library('image_lib', $config);

　また、動的に設定情報が変わらないのであれば、予め「application/config/image_lib.php」設定ファイルで 設定しておくことも可能です。

　以下の設定項目は、全ての操作に共通の設定項目です。

　上記設定項目以外の設定は、それぞれの画像処理毎に説明します。

resize()

　元の画像から、高さ・横幅をリサイズした画像を生成します。

• サムネイル作成
$config = array(
    'source_image' => 'images/any.jpg',
    'width' => 50,
    'create_thumb' => TRUE,
);
$this->load->library('image_lib', $config);

$this->image_lib->resize();
• リサイズしてクライアントに出力
$config = array(
    'source_image' => 'images/any.jpg',
    'width' => 50,
    'dynamic_output' => TRUE,
);
$this->load->library('image_lib', $config);

$this->image_lib->resize();

crop()

　元の画像から画像を切り抜いて新しい画像を生成します。

• 切り抜いた画像を保存
$config = array(
    'source_image' => 'images/any.jpg',
    'new_image' => 'images/cropped_any.jpg',
    'width' => 30,
    'x_axis' => 10,
    'maintain_ratio' => TRUE,
    'master_dim' => 'width',
);
$this->load->library('image_lib', $config);

$this->image_lib->crop();
• 切り抜いた画像をクライアントに出力
$config = array(
    'source_image' => 'images/any.jpg',
    'dynamic_output' => TRUE,
    'width' => 30,
    'height' => 10,
    'x_axis' => 10,
    'y_axis' => 10,
    'maintain_ratio' => FALSE,
);
$this->load->library('image_lib', $config);

$this->image_lib->crop();

rotate()

　元の画像を回転、または、反転させた画像を新しく生成します。

• 上下反転した画像を保存
$config = array(
    'source_image' => 'images/any.jpg',
    'new_image' => 'images/vrt_any.jpg',
    'rotation_angle' => 'vrt',
);
$this->load->library('image_lib', $config);

$this->image_lib->rotate();
• 180度回転させた画像をクライアントに出力
$config = array(
    'source_image' => 'images/any.jpg',
    'dynamic_output' => TRUE,
    'rotation_angle' => 180,
);
$this->load->library('image_lib', $config);

$this->image_lib->rotate();

watermark()

　元の画像上に他の画像を合成した新しい画像を生成します。
合成する画像は、テキストからテキスト画像を生成して合成する方法と、透過画像を合成する方法があります。

• 画像の合成の共通設定

テキスト画像の合成

$config = array(
    'source_image' => 'images/any.png',
    'dynamic_output' => TRUE,
    'wm_type' => 'text',
    'wm_vrt_alignment' => 'M',
    'wm_text' => 'テキスト',
    'wm_font_path' => '/usr/share/fonts/japanese/TrueType/sazanami-gothic.ttf',
    'wm_font_color' => '#ff0000',
);
$this->load->library('image_lib', $config);

$this->image_lib->watermark();

　日本語のテキスト画像を合成する場合は、日本語フォントファイルを指定する必要があります。

透過画像の合成

$config = array(
    'source_image' => 'images/any.png',
    'wm_overlay_path' => 'images/overlay.png',
    'dynamic_output' => TRUE,
    'wm_vrt_alignment' => 'M',
    'wm_type' => 'overlay',
    'wm_opacity' => 30,
);
$this->load->library('image_lib', $config);

$this->image_lib->watermark();

get_image_properties($path = '', $return = FALSE)

　第一引数に指定した画像ファイルの情報を取得します。
　第二引数は、「TRUE」を指定する必要があります。

　第一引数に「NULL」を指定すると、設定値「source_image」で指定した画像ファイルの 情報を取得します。

　このメソッドは、他のメソッドの内部からも利用されており、第二引数に「FALSE」を 指定するのは内部利用のための指定のため、誤って「FALSE」を指定してしまうと 他のメソッドに影響し、思わぬ結果となってしまいますので注意してください。

　取得できる情報は以下になります。

$config = array(
    'source_image' => 'images/any.png',
);
$this->load->library('image_lib', $config);

$info = $this->image_lib->get_image_properties(NULL, TRUE);
print_r($info);


/*
Array (
    [width] => 280
    [height] => 30
    [image_type] => 3
    [size_str] => width="280" height="30"
    [mime_type] => image/png
)
*/                        

　一つのインスタンスで、複数の画像を処理する場合は、一つの処理が終了するたびに設定を初期化する必要があります。

clear()

　一つの処理が終了したら、前の設定をクリアします。

$this->image_lib->clear();

initialize($props = array())

　新しい設定情報をインスタンスに再セットします。

$this->image_lib->initialize($config);

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

　デバッグ時などに利用するエラーメッセ字を取得します。

　第一引数には、メッセージの前に付加する文字列を
　第二引数には、メッセージの後に付加する文字列を指定します。
　デフォルトは、HTMLタグの「<p>」と「</p>」です。

$err_msg = $this->image_lib->display_errors();

　エラーメッセージの多言語化

　デフォルトのエラーメッセージの文言は、「system/language/english/imglib_lang.php」言語ファイルに 定義されています。
　日本語など他の言語で定義して利用する場合は、デフォルトの言語ファイルを
「application/language/言語/」ディレクトリにコピーして編集します。

$ cp system/language/english/imglib_lang.php application/language/japanese/
$ vim application/language/japanese/imglib_lang.php
$this->config->set_item('language', 'japanese');

$this->load->library('image_lib');