array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.exif-thumbnail.php', 1 => 'exif_thumbnail', 2 => 'Получает встроенное превью изображения', ), 'up' => array ( 0 => 'ref.exif.php', 1 => 'Exif Функции', ), 'prev' => array ( 0 => 'function.exif-tagname.php', 1 => 'exif_tagname', ), 'next' => array ( 0 => 'function.read-exif-data.php', 1 => 'read_exif_data', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/exif/functions/exif-thumbnail.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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() считывает встроенное превью изображения.

Если вы хотите получить эскиз посредством этой функции, вам необходимо отправить mimetype-информацию, использовав header() функцию.

Иногда exif_thumbnail() не может создать изображение, но может определить его размер. В таких случаях она возвращает false, но задаёт аргументам width и height правильные значения.

Список параметров

file
Местоположение файла с изображением. Может быть как путём к файлу, так и потоковым ресурсом.
width
Возвращаемая ширина эскиза.
height
Возвращаемая высота эскиза.
image_type
Возвращаемый тип эскиза. Это либо TIFF, либо JPEG.

Возвращаемые значения

Возвращает встроенный эскиз или false, если изображение не содержит эскиза.

Список изменений

Версия Описание
7.2.0 Параметр file переименован в stream и может принимать как локальный путь к файлу, так и потоковый ресурс.

Примеры

Пример #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 {
// нет доступного превью, здесь можно обработать ошибку
echo 'Нет доступного эскиза';
}
?>

Примечания

Замечание: Если параметр file использован для передачи потока в функцию, то этот поток должен быть перематываемым. Обратите внимание, что файловый позиционный указатель не будет изменён после завершения работы этой функции.

Смотрите также