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

Copy
1<?php
2
3/**
4 * 指定された画像ファイルのタイプを判別し、人間が読める形式で返します。
5 *
6 * この関数は、PHPのGD拡張機能と、WebP、JPEG、PNGなどの画像フォーマットに対する
7 * GDライブラリのサポートに依存します。
8 *
9 * @param string $filePath 判別する画像ファイルのパス。
10 * @return string 画像タイプを示す文字列、またはエラーメッセージ。
11 */
12function getImageTypeName(string $filePath): string
13{
14    // ファイルが存在しない、または読み取り不可の場合はエラーを返します。
15    if (!file_exists($filePath) || !is_readable($filePath)) {
16        return "エラー: ファイルが見つからないか、読み取れません。";
17    }
18
19    // getimagesize() 関数は、画像のサイズと種類に関する情報を配列で返します。
20    // 配列のインデックス2には、IMAGETYPE_* 定数に対応する整数値が格納されます。
21    // 例: IMAGETYPE_GIF, IMAGETYPE_JPEG, IMAGETYPE_PNG, IMAGETYPE_WEBP など。
22    $imageInfo = getimagesize($filePath);
23
24    if ($imageInfo === false) {
25        return "エラー: 画像情報を取得できませんでした。ファイルが有効な画像でない可能性があります。";
26    }
27
28    $imageType = $imageInfo[2]; // 画像タイプを示す定数
29
30    switch ($imageType) {
31        case IMAGETYPE_GIF:
32            return "GIF";
33        case IMAGETYPE_JPEG:
34            return "JPEG";
35        case IMAGETYPE_PNG:
36            return "PNG";
37        case IMAGETYPE_WEBP: // IMAGETYPE_WEBP 定数を使用してWebP画像を識別します。
38            return "WebP";
39        case IMAGETYPE_BMP:
40            return "BMP";
41        case IMAGETYPE_ICO:
42            return "ICO";
43        case IMAGETYPE_TIFF_II:
44        case IMAGETYPE_TIFF_MM:
45            return "TIFF";
46        case IMAGETYPE_PSD:
47            return "PSD (Photoshop)";
48        case IMAGETYPE_SWF:
49            return "SWF (Flash)";
50        // 他の画像タイプも必要に応じて追加できます。
51        default:
52            return "不明な画像タイプ (コード: " . $imageType . ")";
53    }
54}
55
56// --- サンプルコードの実行 ---
57// このセクションは、getImageTypeName() 関数の動作を示すために、
58// 一時的なダミー画像を生成し、そのタイプを判別します。
59// 実行にはPHPのGD拡張機能が有効になっている必要があります。
60
61$tempDir = sys_get_temp_dir(); // システムの一時ディレクトリを取得
62$testFiles = []; // 生成した一時ファイルのパスを保存する配列
63
64echo "--- 画像タイプ判別テスト ---" . PHP_EOL;
65
66// WebPダミー画像の生成とテスト
67$webpFile = $tempDir . '/example_test.webp';
68if (function_exists('imagewebp')) {
69    $image = imagecreatetruecolor(50, 50); // 50x50ピクセルの画像を生成
70    $bgColor = imagecolorallocate($image, 255, 255, 255); // 白色を割り当てる
71    imagefill($image, 0, 0, $bgColor); // 画像を白で塗りつぶす
72    if (imagewebp($image, $webpFile)) { // WebP形式でファイルを保存
73        $testFiles[] = $webpFile;
74        echo "WebPファイル (" . basename($webpFile) . "): " . getImageTypeName($webpFile) . PHP_EOL;
75    } else {
76        echo "警告: WebP画像の生成に失敗しました (GD拡張のWebPサポートがない可能性があります)。" . PHP_EOL;
77    }
78    imagedestroy($image); // メモリを解放
79} else {
80    echo "警告: GD拡張のimagewebp()関数が利用できません。WebPファイルのテストをスキップします。" . PHP_EOL;
81}
82
83// JPEGダミー画像の生成とテスト
84$jpegFile = $tempDir . '/example_test.jpg';
85if (function_exists('imagejpeg')) {
86    $image = imagecreatetruecolor(50, 50);
87    $bgColor = imagecolorallocate($image, 255, 255, 255);
88    imagefill($image, 0, 0, $bgColor);
89    if (imagejpeg($image, $jpegFile)) { // JPEG形式でファイルを保存
90        $testFiles[] = $jpegFile;
91        echo "JPEGファイル (" . basename($jpegFile) . "): " . getImageTypeName($jpegFile) . PHP_EOL;
92    } else {
93        echo "警告: JPEG画像の生成に失敗しました (GD拡張のJPEGサポートがない可能性があります)。" . PHP_EOL;
94    }
95    imagedestroy($image);
96} else {
97    echo "警告: GD拡張のimagejpeg()関数が利用できません。JPEGファイルのテストをスキップします。" . PHP_EOL;
98}
99
100// PNGダミー画像の生成とテスト
101$pngFile = $tempDir . '/example_test.png';
102if (function_exists('imagepng')) {
103    $image = imagecreatetruecolor(50, 50);
104    $bgColor = imagecolorallocate($image, 255, 255, 255);
105    imagefill($image, 0, 0, $bgColor);
106    if (imagepng($image, $pngFile)) { // PNG形式でファイルを保存
107        $testFiles[] = $pngFile;
108        echo "PNGファイル (" . basename($pngFile) . "): " . getImageTypeName($pngFile) . PHP_EOL;
109    } else {
110        echo "警告: PNG画像の生成に失敗しました (GD拡張のPNGサポートがない可能性があります)。" . PHP_EOL;
111    }
112    imagedestroy($image);
113} else {
114    echo "警告: GD拡張のimagepng()関数が利用できません。PNGファイルのテストをスキppedします。" . PHP_EOL;
115}
116
117// 存在しないファイルのテスト
118$nonExistentFile = $tempDir . '/non_existent_test.file';
119echo "存在しないファイル (" . basename($nonExistentFile) . "): " . getImageTypeName($nonExistentFile) . PHP_EOL;
120
121// テスト後、生成した一時ファイルをクリーンアップします。
122foreach ($testFiles as $file) {
123    if (file_exists($file)) {
124        unlink($file); // ファイルを削除
125    }
126}
127
128?>

このPHPサンプルコードは、画像ファイルのタイプを判別し、その種類を人間が読める形式の文字列で返す方法をシステムエンジニアの初心者に示しています。特に、PHPのGD拡張機能でWebP画像を識別するために使われるIMAGETYPE_WEBP定数の利用例が強調されています。

getImageTypeName関数は、判別したい画像ファイルのパス（$filePath）を引数として受け取ります。この関数は、内部でPHPの標準関数であるgetimagesize()を使用し、指定された画像に関する詳細な情報を取得します。getimagesize()は、画像の幅、高さ、そして画像タイプを示す整数値を配列として返します。この整数値は、IMAGETYPE_GIFやIMAGETYPE_JPEG、そして本定数であるIMAGETYPE_WEBPといったPHPの定義済み定数に対応しています。getImageTypeName関数は、取得した整数値をこれらの定数と比較することで、正確な画像タイプを特定し、「WebP」や「JPEG」のような文字列として戻り値で返します。ファイルが見つからない場合や画像として無効な場合は、エラーメッセージが返されます。

サンプルコードの下部では、実際にWebP、JPEG、PNG形式の一時的なダミー画像を生成し、getImageTypeName関数を呼び出すことで、様々な画像タイプが正しく判別される様子を具体的に確認できます。このコードの実行には、PHPのGD拡張機能が有効になっている必要があります。

Copy
1<?php
2
3/**
4 * JPEG画像をWebP形式に変換し、生成されたWebPファイルが
5 * IMAGETYPE_WEBP定数で正しく識別されるかを確認するサンプルコードです。
6 *
7 * このコードを実行するには、PHPにGD拡張モジュールとexif拡張モジュールが
8 * 有効になっている必要があります。
9 */
10function convertAndVerifyWebp(): void
11{
12    // 一時的なJPEGファイルのパスを定義
13    $tempJpegPath = __DIR__ . '/sample_image.jpg';
14    // 出力するWebPファイルのパスを定義
15    $outputWebpPath = __DIR__ . '/output_image.webp';
16
17    // 1. サンプルJPEG画像を生成します。
18    // 単体で動作可能にするため、GDライブラリで簡易的な画像を作成し、JPEGとして保存します。
19    $image = imagecreatetruecolor(200, 100);
20    if ($image === false) {
21        echo "エラー: GDリソースの作成に失敗しました。GD拡張が有効か確認してください。" . PHP_EOL;
22        return;
23    }
24    $bgColor = imagecolorallocate($image, 255, 255, 255); // 白
25    $textColor = imagecolorallocate($image, 0, 0, 0);     // 黒
26    imagefill($image, 0, 0, $bgColor);
27    imagestring($image, 5, 50, 40, 'Hello WebP!', $textColor);
28
29    // 作成した画像をJPEGとして保存
30    if (!imagejpeg($image, $tempJpegPath)) {
31        echo "エラー: サンプルJPEGファイルの保存に失敗しました。" . PHP_EOL;
32        imagedestroy($image);
33        return;
34    }
35    imagedestroy($image); // GDリソースを解放
36
37    echo "一時的なJPEGファイルを作成しました: " . $tempJpegPath . PHP_EOL;
38
39    // 2. 作成したJPEGファイルをGDリソースとして読み込みます。
40    $gdImage = imagecreatefromjpeg($tempJpegPath);
41    if ($gdImage === false) {
42        echo "エラー: JPEGファイルの読み込みに失敗しました。" . PHP_EOL;
43        unlink($tempJpegPath); // 一時ファイルを削除して終了
44        return;
45    }
46
47    // 3. GDリソースをWebP形式で保存します。
48    // imagewebp() 関数は、GDリソースをWebP形式のファイルとして出力します。
49    $quality = 80; // WebPの品質設定 (0-100)
50
51    if (imagewebp($gdImage, $outputWebpPath, $quality)) {
52        echo "画像をWebP形式で保存しました: " . $outputWebpPath . PHP_EOL;
53
54        // 4. 保存したWebPファイルの画像タイプを確認します。
55        // IMAGETYPE_WEBP は、WebP形式の画像タイプを表す組み込み定数です。
56        // exif_imagetype() 関数は、指定されたファイルの画像タイプを整数値で返します。
57        $imageType = exif_imagetype($outputWebpPath);
58
59        if ($imageType !== false) {
60            echo "保存されたWebPファイルの画像タイプ: " . $imageType . PHP_EOL;
61
62            // IMAGETYPE_WEBP 定数と比較し、WebP形式であることを確認します。
63            if ($imageType === IMAGETYPE_WEBP) {
64                echo "成功: 画像は正しくWebP形式として識別されました (IMAGETYPE_WEBP の値: " . IMAGETYPE_WEBP . ")" . PHP_EOL;
65            } else {
66                echo "警告: 画像がWebP形式として識別されませんでした。実際のタイプ: " . $imageType . PHP_EOL;
67            }
68        } else {
69            echo "エラー: WebPファイルの画像タイプ検出に失敗しました。exif拡張が有効か確認してください。" . PHP_EOL;
70        }
71    } else {
72        echo "エラー: WebP形式での画像保存に失敗しました。GD拡張がWebPをサポートしているか確認してください。" . PHP_EOL;
73    }
74
75    // GDリソースを解放します。
76    imagedestroy($gdImage);
77
78    // 5. 作成した一時ファイルをクリーンアップします。
79    // サンプルコード実行後に余計なファイルが残らないように削除します。
80    if (file_exists($tempJpegPath)) {
81        unlink($tempJpegPath);
82        echo "一時的なJPEGファイルを削除しました: " . $tempJpegPath . PHP_EOL;
83    }
84    if (file_exists($outputWebpPath)) {
85        unlink($outputWebpPath);
86        echo "生成されたWebPファイルを削除しました: " . $outputWebpPath . PHP_EOL;
87    }
88}
89
90// 関数を実行します。
91convertAndVerifyWebp();

IMAGETYPE_WEBPは、PHPのGD拡張モジュールが提供する組み込み定数の一つで、画像ファイルのWebP形式を表す整数値です。定数であるため、引数や戻り値は存在しません。この定数は、主にexif_imagetype()関数などの画像タイプを判定する関数と組み合わせて使用され、ファイルがWebP形式であるかを識別する際に役立ちます。

提供されたサンプルコードでは、まずGDライブラリを使って簡単なJPEG画像を生成し、そのJPEG画像をimagewebp()関数でWebP形式に変換して保存します。imagewebp()関数は、指定されたGDリソース（画像データ）をWebP形式の画像ファイルとして出力する役割を持ちます。その後、exif_imagetype()関数を用いて保存されたWebPファイルの画像タイプを検出し、その結果がIMAGETYPE_WEBP定数の値と一致するかを確認しています。これにより、生成されたファイルが正しくWebP形式として処理されたかを検証できます。

システム開発において、Webアプリケーションなどでユーザーからアップロードされた画像の形式を検証したり、JPEGやPNGなどの画像をWebP形式に変換してウェブパフォーマンスを向上させたりする場面で、このIMAGETYPE_WEBP定数と関連関数が活用されます。このコードを実行するには、PHPにGD拡張モジュールとexif拡張モジュールが有効になっている必要があります。