PHP マニュアル: 画像に埋め込まれたサムネイルを取得する

説明

stringfalse exif_thumbnail(
    resourcestring $file,
    int &$width = null,
    int &$height = null,
    int &$image_type = null
)

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

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

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

パラメータ

file: 読み込む画像ファイルの名前。サムネイルが埋め込まれています。画像ファイルの位置。これはファイルのパスか、ストリーム resource です。
width: 返されるサムネイルの幅が格納されます。
height: 返されるサムネイルの高さが格納されます。
image_type: 返されるサムネイルの画像タイプが格納されます。 TIFF あるいは JPEG のどちらかです。

戻り値

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

変更履歴

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

例

例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
image_type_to_mime_type