exif_thumbnail
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
exif_thumbnail — Recupera a miniatura embutida de uma imagem
Descrição
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