exif_thumbnail

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    exif_thumbnail — 画像に埋め込まれたサムネイルを取得する

    説明

    exif_thumbnail(
        resource|string$file,
        int&$width = null,
        int&$height = null,
        int&$image_type = null
    ): string|false

    exif_thumbnail() は、 画像に埋め込まれたサムネイルを読み込みます。

    この関数を使用してサムネイルを出力したい場合は、 header() 関数を使用して mimetype 情報を送信する 必要があります。

    exif_thumbnail() が画像を作成することはできないが、 そのサイズだけはわかるという可能性があります。そのような場合、戻り値は false となりますが width および height を設定されています。

    パラメータ

    file

    読み込む画像ファイルの名前。サムネイルが埋め込まれています。 画像ファイルの位置。これはファイルのパスか、ストリーム resource です。

    width

    返されるサムネイルの幅が格納されます。

    height

    返されるサムネイルの高さが格納されます。

    image_type

    返されるサムネイルの画像タイプが格納されます。 TIFF あるいは JPEG のどちらかです。

    戻り値

    埋め込まれたサムネイルを返します。画像がサムネイルを含まない場合は false を返します。

    変更履歴

    バージョン説明
    7.2.0file パラメータは ローカルファイルとストリームリソースを両方サポートするようになりました。

    例

    例1 exif_thumbnail() の例

    <?php
    $image     = exif_thumbnail('/path/to/image.jpg', $width, $height, $type);
    if (    $image!==false) {
    header('Content-type: ' .image_type_to_mime_type($type));
    echo     $image;
    exit;
    } else {
    // no thumbnail available, handle the error here
    echo 'No thumbnail available';
    }
    ?>

    注意

    注意:

    この関数にストリームを渡すために file を使った場合、 ストリームはシーク可能でなければなりません。 ファイルポインタの位置は、関数から戻った後でも変化しないことに注意してください。

    参考

    • exif_read_data() - 画像ファイルから EXIF ヘッダを読み込む
    • image_type_to_mime_type() - getimagesize, exif_read_data, exif_thumbnail, exif_imagetypeから返される 画像形式のMIMEタイプを取得する
    To Top