トップページ　→関数リファレンス　→画像処理および作成　→Exif　→Exif 関数

関数・クラス解説

exif_thumbnail

version:PHP 4 >= 4.2.0, PHP 5, PHP 7 (公式)

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

公式リファレンス

書式

exif_thumbnail ( mixed $stream [, int &$width [, int &$height [, int &$imagetype ]]] ) : string

説明

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

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

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

パラメータ

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

返値

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

注意

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

更新履歴

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

サンプル

例1 exif_thumbnail() の例 

$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';
}