導入

PHPができることは、HTML出力を生成することだけではありません。PHP は、多くの異なるイメージ形式でイメージファイルを作成したり、操作 したりすることもできます。このイメージ形式には、gif, png, jpg, wbmp, xpmが含まれます。さらに便利なことに、PHPはイメージストリー ムを直接ブラウザに出力することができます。 これを動作されるには、イメージ関数のGDライブラリを指定してPHPをコ ンパイル必要があります。使用したいイメージ形式によっては、GDとPHP は他のライブラリも必要とする可能性があります。

PHPのイメージ関数により JPEG、GIF、 PNG、SWF、 TIFF、JPEG2000イメージの 大きさを知ることができます。

要件

GDライブラリ( http://www.boutell.com/gd/で取得可能)があれば、画像の作成と操 作を行なうこともできます。

操作できるイメージの形式は、インストールされている GDとこれらのイメージフォーマットにアクセスする ためにGDが必要とするその他のライブラリに依存し ます。gd-1.6より前のバージョンのgdは、GIFイメージ画像をサポートし ていますが、PNGはサポートしていません。一方、gd-1.6以降のバージョ ンはPNGをサポートし、GIFはサポートしていません。

より多くのイメージ形式を処理するためにGDを拡張したいと思うかもし れません。

別の種類のフォントを処理できるようにGDを拡張したいと思うかもしれ ません。以下にサポートされるフォントライブラリを示します。

--enable-exifを指定してPHPをコ ンパイルした場合、JPEGおよび TIFFイメージのヘッダに格納された情報を処理する ことができるようになります。これにより、以下に示すようにデジタル カメラにより生成されたメタデータを読むことができるようになります。 以下の関数は、GDライブラリを必要としません。

インストール手順

PHPでGDサポートを有効にするには、configure に--with-gd[=DIR]を指定します。ただし、DIRは GDのベースインストールディレクトリです。 PHPにバンドルされている推奨のGDライブラリを使用するには --with-gdを指定します。 Windowsの場合、GD2 DLL php_gd2.dllをphp.iniに エクステンションとして指定してください。 GD1 DLL php_gd.dllはPHP4.3.2で削除されました。 imagecreatetruecolor()のようにTrueカラーが優先される関数 についてはGD2が必須です。

PHP3においてGDサポートを無効にするには --without-gdを指定してください。

より多くの画像フォーマットを扱えるようにGDの能力を高めるには、 --with-XXXXのような形のオプションを指定します。

GDがより多くのフォントを扱えるようにするには --with-XXXXのような形のオプションを指定します。 line.

実行用の設定

これらの関数の動作は、php.iniの設定により変化します。

Exifは、モジュールmbstringが利用 可能な場合に、UnicodeとユーザコメントのJIS文字エンコーディングの変換を 自動的にサポートします。これは、指定された文字セットを用いてまずコメ ントをデコードすることにより行なわれます。次にこの結果は HTTP出力にマッチする他の文字セットにエンコードされます。

以下に設定ディレクティブに関す る簡単な説明を示します。

リソース型

この拡張モジュールはリソース型を全く定義しません。

定義済みの定数

これらの定数は、この拡張モジュールで定義されており、 この拡張モジュールがPHP内部にコンパイルされているか実行時に動的にロー ドされるかのどちらかの場合のみ使用可能です。

例

例 1. PHPによるPNGの生成 <?php     header("Content-type: image/png");     $string = $_GET['text'];     $im     = imagecreatefrompng("images/button1.png");     $orange = imagecolorallocate($im, 220, 210, 60);     $px     = (imagesx($im) - 7.5 * strlen($string)) / 2;     imagestring($im, 3, $px, 9, $string, $orange);     imagepng($im);     imagedestroy($im); ?>

この例のスクリプトは、<img src="button.php?text"> のようなタグによりあるページからコールされるものです。 上のbutton.phpスクリプトは、この "text" 文字列を引数と し、この場合は "images/button1.png" である基本イメージ の最上部にこの文字列を描いた後、描画後ののイメージを出力します。 この方法は、ボタンのテキストを変更する度に新規のボタンを生成する 必要があるのを回避するために便利な手法です。 この方法により、動的にイメージボタンを生成できます。