【PHP8.x】IMAGETYPE_GIF定数の使い方

Copy
1<?php
2
3/**
4 * 指定された画像ファイルのタイプを判別し、その結果を表示します。
5 *
6 * この関数は、PHPの `getimagesize()` 関数と `IMAGETYPE_*` 定数を使用して
7 * 画像の種類を判別する方法を示します。IMAGETYPE_GIF や IMAGETYPE_JPEG などの定数は、
8 * 特定の画像形式を表す整数値であり、画像ファイルの形式を識別する際に利用されます。
9 *
10 * @param string $filePath 判別したい画像ファイルのパス
11 * @return void
12 */
13function identifyImageType(string $filePath): void
14{
15    // 指定されたファイルが存在するかを確認します。
16    // ファイルが存在しない場合はエラーメッセージを表示し、処理を終了します。
17    if (!file_exists($filePath)) {
18        echo "エラー: ファイル '{$filePath}' が見つかりません。\n";
19        echo "ヒント: テスト用に適切な画像ファイル (例: test.gif, test.jpg, test.png) を用意し、パスを修正してください。\n";
20        return;
21    }
22
23    // getimagesize() 関数で画像情報を取得します。
24    // 成功した場合、画像に関する情報が配列として返され、そのインデックス2には
25    // 画像タイプを表す定数値（例: 1=IMAGETYPE_GIF, 2=IMAGETYPE_JPEG）が格納されます。
26    // 失敗した場合（例: ファイルが画像ではない場合）、falseが返されます。
27    $imageInfo = getimagesize($filePath);
28
29    // 画像情報の取得に失敗した場合
30    if ($imageInfo === false) {
31        echo "エラー: ファイル '{$filePath}' は有効な画像ファイルではないか、または読み取れませんでした。\n";
32        return;
33    }
34
35    // 配列のインデックス2から画像タイプを表す整数値を取得します。
36    $imageType = $imageInfo[2];
37
38    echo "ファイル: '{$filePath}' の画像タイプを判別します。\n";
39    echo "取得された内部画像タイプ値: {$imageType}\n";
40
41    // 取得した画像タイプを PHP の IMAGETYPE_* 定数と比較して種類を判別し、表示します。
42    switch ($imageType) {
43        case IMAGETYPE_GIF:
44            echo "結果: この画像は GIF 形式です。\n";
45            break;
46        case IMAGETYPE_JPEG:
47            echo "結果: この画像は JPEG 形式です。\n";
48            break;
49        case IMAGETYPE_PNG:
50            echo "結果: この画像は PNG 形式です。\n";
51            break;
52        // その他の画像タイプも、IMAGETYPE_WEBP や IMAGETYPE_BMP など、
53        // 同様の定数を使って判別することができます。
54        default:
55            echo "結果: この画像は不明な形式、またはこのスクリプトで対応していない形式です。\n";
56            break;
57    }
58}
59
60// 実行例: GIF画像を判別
61// このスクリプトと同じディレクトリに 'example.gif' というGIF画像ファイルを用意して試してください。
62identifyImageType('example.gif');
63
64echo "\n-----------------------------------\n\n"; // 区切り線
65
66// 実行例: JPEG画像を判別
67// このスクリプトと同じディレクトリに 'example.jpg' というJPEG画像ファイルを用意して試してください。
68identifyImageType('example.jpg');
69
70echo "\n-----------------------------------\n\n"; // 区切り線
71
72// 実行例: PNG画像を判別
73// このスクリプトと同じディレクトリに 'example.png' というPNG画像ファイルを用意して試してください。
74identifyImageType('example.png');
75
76?>

このPHPコードは、指定された画像ファイルの種類（GIF、JPEG、PNGなど）を判別し、その結果を表示します。identifyImageType関数は、判別したい画像ファイルのパスを文字列型の引数$filePathとして受け取ります。

関数内部では、まずgetimagesize()関数を使用して画像ファイルの情報を取得します。この関数は、画像が有効であれば、その幅、高さ、そして画像タイプを表す数値などが含まれた配列を返します。特に、返される配列のインデックス2には、画像タイプを示す整数値が格納されています。

次に、取得した画像タイプを示す数値が、PHPに予め定義されているIMAGETYPE_GIF、IMAGETYPE_JPEG、IMAGETYPE_PNGといった定数と比較されます。これらの定数は、それぞれ特定の画像形式（例: IMAGETYPE_GIFはGIF形式）に対応する固有の整数値を持ちます。コードではswitch文を用いて、取得した数値がどの定数と一致するかを判別し、その結果に応じたメッセージを画面に出力します。

identifyImageType関数の戻り値はvoidとなっており、値を返さずに処理結果を直接表示する動作をします。このように、PHPの標準関数と定数を組み合わせることで、画像ファイルの種類を簡単に識別し、それに応じた処理をプログラムに組み込むことができます。