Получает встроенное превью изображения

# exif_thumbnail

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

exif_thumbnail — Получает встроенное превью изображения

### Описание

function 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` использован для передачи потока в функцию, то этот поток должен быть перематываемым. Обратите внимание, что файловый позиционный указатель не будет изменён после завершения работы этой функции.

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

- exif_read_data() - Читает заголовки EXIF из файлов изображений
- image_type_to_mime_type() - Получение Mime-типа для типа изображения, возвращаемого функциями getimagesize, exif_read_data, exif_thumbnail, exif_imagetype

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open