exif_thumbnail
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
exif_thumbnail — Получает встроенное превью изображения
Описание
$file
, int &$width
= null
, int &$height
= null
, int &$image_type
= null
) : string|falseexif_thumbnail() считывает встроенное превью изображения.
Если вы хотите получить эскиз посредством этой функции, вам необходимо отправить mimetype-информацию, использовав header() функцию.
Иногда exif_thumbnail()
не может создать изображение, но может определить его размер.
В таких случаях она возвращает false
, но задает аргументам
width
и height
правильные значения.
Список параметров
-
file
-
Местоположение файла с изображением. Может быть как путем к файлу, так и потоковым ресурсом.
-
width
-
Возвращаемая ширина эскиза.
-
height
-
Возвращаемая высота эскиза.
-
image_type
-
Возвращаемый тип эскиза. Это либо TIFF, либо JPEG.
Возвращаемые значения
Возвращает встроенный эскиз или false
, если изображение
не содержит эскиза.
Примеры
Пример #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 'Нет доступного эскиза';
}
?>
Список изменений
Версия | Описание |
---|---|
7.2.0 |
Параметр file переименован в
stream и может принимать как локальный путь
к файлу, так и потоковый ресурс.
|
Примечания
Замечание:
Если параметр
file
использован для передачи потока в функцию, то этот поток должен быть перематываемым. Обратите внимание, что файловый позиционный указатель не будет изменен после завершения работы этой функции.
Смотрите также
- exif_read_data() - Читает заголовки EXIF из файлов изображений
- image_type_to_mime_type() - Получение Mime-типа для типа изображения, возвращаемого функциями getimagesize, exif_read_data, exif_thumbnail, exif_imagetype