exif_read_data
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
exif_read_data — Lê os cabeçalhos EXIF de um arquivo de imagen
Descrição
Cabeçalhos EXIF tendem a estar presentes em imagens JPEG/TIFF geradas por camêras
digitais, mas infelizmente, cada fabricante de camêra digital tem
uma idéia diferente de como marcar as suas imagens, então não se
pode confiar sempre que um cabeçalho EXIF específico estará presente.
Altura (Height
) e largura (Width
) sao computadas
da mesma maneira que getimagesize() faz, então seus valores não devem
ser parte de nenhum cabeçalho retornado. Além disso, html
é
uma string de texto com altura/largura a ser usado dentro de umHTML normal.
Quando um cabeçalho Exif contém uma nota de direitos autorais, esta nota pode conter dois
valores. Como a solução é inconsistente com o padrão Exif 2.10 a seção
COMPUTED
irá retornar ambas as entradas
Copyright.Photographer
e Copyright.Editor
enquando que as seções IFD0
contém um array de bytes com o caractere NULL que separa as duas
entradas. Ou apenas a primeira entrada se o tipo de dados estiver errado (funcionamento normal
do Exif). COMPUTED
irá conter também a entrada
Copyright
que será a string original do copyright
ou uma lista separada por vírgula dos direitos autorais da foto e do editor.
A marca UserComment
tem o mesmo problema que a marca de
Copyright. Ela pode guardar dois valores. Primeiro a codificação usada e em segundo o valor
em si. Então a seção IFD
contém somente a codificação
ou um array de bytes. A seção COMPUTED
irá guardar ambos nas
entradas UserCommentEncoding
e
UserComment
. A entrada UserComment
está disponível em ambos os casos então deve ser usada em preferência ao
valor da seção IFD0
.
exif_read_data() também valida marcas de dados EXIF de acordo
com a especificação EXIF (» http://exif.org/Exif2-2.PDF, página 20).
Parâmetros
file
-
A localização do arquivo de imagem. Pode ser uma caminho para o arquivo
(empacotadores de fluxo são também suportados)
ou um fluxo do tipo resource.
required_sections
-
Uma lista de seções separadas por vírgula que precisam estar presentes no arquivo
para produzir o resultado do tipo array. Se nenhuma das seções informadas
puder ser encontrada o valor de retorno é false
.
as_arrays
-
Especifica se cada seção se torna ou não um array. As seções
COMPUTED
, THUMBNAIL
E
COMMENT
de required_sections
sempre se toranm arrays por que contêm valores cujos nomes conflitam
com outras seções.
read_thumbnail
-
Quando definida para true
a miniatura em si é lida. Caso contrário, apenas
os dados marcados são ligos.
Valor Retornado
Retorna um array associativo onde os índices são
os nomes dos cabeçalhos e os valores são os associados com
esses cabeçalhos. Se nenhum dado puder ser retornado,
exif_read_data() retornará false
.
Erros/Exceções
Erros de nível E_WARNING
e/ou E_NOTICE
podem ser disparados para marcas não suportadas ou outras condições de erros potenciais, mas a
função ainda tenta lêr toda a informação compreensível.
Exemplos
Exemplo #1 Exemplo exif_read_data()
<?php
echo "test1.jpg:<br />\n";
$exif = exif_read_data('tests/test1.jpg', 'IFD0');
echo $exif===false ? "Dados de cabeçalho não encontrados.<br />\n" : "Imagem contém cabeçalhos<br />";
$exif = exif_read_data('tests/test2.jpg', 0, true);
echo "test2.jpg:<br />\n";
foreach ($exif as $key => $section) {
foreach ($section as $name => $val) {
echo "$key.$name: $val<br />\n";
}
}
?>
A primeira chamada falha porque a imagem não tem informações no cabeçalho.
O exemplo acima produzirá
algo semelhante a:
test1.jpg:
Dados de cabeçalho não encontrados.
test2.jpg:
FILE.FileName: test2.jpg
FILE.FileDateTime: 1017666176
FILE.FileSize: 1240
FILE.FileType: 2
FILE.SectionsFound: ANY_TAG, IFD0, THUMBNAIL, COMMENT
COMPUTED.html: width="1" height="1"
COMPUTED.Height: 1
COMPUTED.Width: 1
COMPUTED.IsColor: 1
COMPUTED.ByteOrderMotorola: 1
COMPUTED.UserComment: Exif test image.
COMPUTED.UserCommentEncoding: ASCII
COMPUTED.Copyright: Photo (c) M.Boerger, Edited by M.Boerger.
COMPUTED.Copyright.Photographer: Photo (c) M.Boerger
COMPUTED.Copyright.Editor: Edited by M.Boerger.
IFD0.Copyright: Photo (c) M.Boerger
IFD0.UserComment: ASCII
THUMBNAIL.JPEGInterchangeFormat: 134
THUMBNAIL.JPEGInterchangeFormatLength: 523
COMMENT.0: Comment #1.
COMMENT.1: Comment #2.
COMMENT.2: Comment #3end
THUMBNAIL.JPEGInterchangeFormat: 134
THUMBNAIL.Thumbnail.Height: 1
THUMBNAIL.Thumbnail.Height: 1
Exemplo #2 exif_read_data() com fluxos, disponível a partir do PHP 7.2.0
<?php
// Abre um arquivos, deve ser em modo binário
$fp = fopen('/path/to/image.jpg', 'rb');
if (!$fp) {
echo 'Erro: Não foi possível abrir a imagem para leitura';
exit;
}
// Tenta ler o cabeçalhos exif
$headers = exif_read_data($fp);
if (!$headers) {
echo 'Erro: Não foi possível ler os cabeçalhos exif';
exit;
}
// Mostra os cabeçalhos de 'COMPUTED'
echo 'Cabeçalhos EXIF:' . PHP_EOL;
foreach ($headers['COMPUTED'] as $header => $value) {
printf(' %s => %s%s', $header, $value, PHP_EOL);
}
?>
O exemplo acima produzirá
algo semelhante a:
Cabeçalhos EXIF:
Height => 576
Width => 1024
IsColor => 1
ByteOrderMotorola => 0
ApertureFNumber => f/5.6
UserComment =>
UserCommentEncoding => UNDEFINED
Copyright => Denis
Thumbnail.FileType => 2
Thumbnail.MimeType => image/jpeg
Notas
Nota:
Se mbstring estiver habilitado, exif tentará processar
em codificação unicode e escolher um conjunto de caracteres como especificado por
exif.decode_unicode_motorola e
exif.decode_unicode_intel. A extensão
exif não tentará descobrir a codificação por si mesma, é responsabilidade do programador
especificar corretamente a codificação a ser usada, configurando uma das duas
diretivas ini antes de chamar exif_read_data().
Nota:
Se file
for usado para passar um fluxo a esta função, o fluxo
deve ser do tipo pesquisável. Note que a posição do ponteiro do arquivo não é alterada depois que esta função retorna.