exif_thumbnail

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

exif_thumbnailRecupera 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

Example #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

Note:

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