Recupera a miniatura embutida de uma imagem

Descrição

exif_thumbnail(
    resource|string $file,
    int &$width = null,
    int &$height = null,
    int &$image_type = null
): string|false

exif_thumbnail() lê a miniatura embutida de uma imagem.

Se for desejado exibir miniaturas através desta função, deve-se enviar a informação do tipo de mídia usando a função header().

É possível que exif_thumbnail() não possa criar uma imagem mas possa determinar seu tamanho. Neste caso, o valor retornado é false mas a largura (width) e altura (height) serão definidos.

Parâmetros

file: A localização do arquivo de imagem. Pode ser um caminho ou um fluxo do tipo resource.
width: A largura da miniatura retornada.
height: A altura da miniatura retornada.
image_type: O tipo da imagem da miniatura retornada. Pode ser TIFF ou JPEG.

Valor Retornado

Retorna a miniatura embutida, ou false se a imagem não contiver miniatura.

Registro de Alterações

Versão	Descrição
7.2.0	O parâmetro `file` agora suporta arquivos locais e recursos de fluxo.

Exemplos

Exemplo #1 Exemplo de 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 {
    // sem miniatura, gerencia o erro aqui
    echo 'Não há miniatura disponível';
}
?>

Notas

Nota: Se o parâmetro file for usado para passar um fluxo a esta função, ele deve ser do tipo pesquisável. Note que a posição do ponteiro do arquivo não é alterada após o retorno desta função.

Veja Também

exif_read_data() - Lê os cabeçalhos EXIF de um arquivo de imagen
image_type_to_mime_type() - Obtém o Mime-Type para o tipo de imagem retornado por getimagesize, exif_read_data, exif_thumbnail e exif_imagetype