(PHP 4 >= 4.2.0, PHP 5)
exif_read_data — Читает EXIF-заголовки JPEG и TIFF изображений
$filename
[, string $sections = NULL
[, bool $arrays = false
[, bool $thumbnail = false
]]] )exif_read_data() читает EXIF-заголовки JPEG и TIFFфайлов. Таким образом можно читать метаданные, генерируемые цифровыми фотоаппаратами.
По идее, EXIF-заголовки должны идти первыми в JPEG/TIFF файлах, генерируемых фотоаппаратами. Но, к сожалению, каждый производитель имеет свое представление того, каким образом компоновать метаданные изображения. Поэтому будьте готовы к ситуации, когда перед Exif-заголовком есть еще что-то.
Height и Width вычисляются аналогично вычислениям getimagesize(), так что эти параметры не обязаны присутствовать в заголовке. html - текстовая строка, задающая высоту/ширину, которую можно использовать в обычном HTML.
Если Exif-заголовок содержит сообщение об авторских правах (Copyright), само сообщение может содержать 2 значения. Эта ситуация не описана в стандарте Exif 2.10, поэтому раздел COMPUTED будет содержать оба этих значения в полях Copyright.Photographer и Copyright.Editor. В то же время разделы IFD0 будут содержать массив байт с NULL-символом в качестве разделителся этих двух значений либо только первое значение, если тип файла определен неверно (нормальная ситуация для Exif). Раздел COMPUTED будет также содержать Copyright, это может быть либо исходная строка, либо список из владельца фотографии и редактора через запятую.
Тэг UserComment имеет те же проблемы, что и Copyright. Он может хранить 2 значения. Первое - использованную кодировку, второе - само значение. В этом случае раздел IFD содержит либо кодировку, либо массив байт. Раздел COMPUTED будет хранить оба этих значения в полях UserCommentEncoding и UserComment. Содержимое UserComment будет доступно в любом случае, поэтому предпочтительней использовать его вместо раздела IFD0.
Также exif_read_data() проверяет EXIF тэги на соответствие спецификации EXIF (» http://exif.org/Exif2-2.PDF, стр. 20).
Замечание:
Windows Me/XP могут затирать Exif-заголовки при подключении фотоаппарата.
filenameИмя файла изображения. Нельзя передавать URL.
sections
Список разделенных запятой разделов, которые должны быть представлены
в результирующем массиве array. Если ни один из разделов найти
не удастся, функция вернет FALSE.
| FILE | FileName, FileSize, FileDateTime, SectionsFound |
| COMPUTED | html, Width, Height, IsColor, и другие. Height and Width вычисляются аналогично getimagesize(), поэтому их не обязательно включать в заголовок. html - текстовая строка, задающая высоту/ширину, которую можно использовать в обычном HTML. |
| ANY_TAG | Любая информация заключенная в тэг, например IFD0, EXIF, ... |
| IFD0 | Все данные тэга IFD0. В обычных изображениях в нем хранится размер изображения. |
| THUMBNAIL | Если файл содержит второй раздел IFD, то считается, что у изображения есть эскиз. Вся информация об эскизе хранится в этом разделе. |
| COMMENT | Заголовки комментариев JPEG изображений. |
| EXIF | Раздел EXIF является подразделом IFD0. Он содержит более детальную информацию об изображении. Большинство его записей зависит от фотоаппарата. |
arrays
Определяет, формировать ли разделы в виде массивов. Разделы
sections, COMPUTED,
THUMBNAIL и COMMENT всегда
делаются массивами, так как они могут содержать значения, имена которых
будут конфликтовать с именами в других разделах.
thumbnail
Если TRUE, будет прочитан сам эскиз. В противном случае будет прочитана
только информация в тэгах.
Возвращает ассоциативный массив array, в котором ключами будут
имена заголовков, а значениями - значения соответствующие этим заголовкам.
Если никаких данных вернуть нельзя, exif_read_data()
вернет FALSE.
| Версия | Описание |
|---|---|
| 4.3.0 | Может читать все встроенные IFD данные, включая массивы. Размер встроенного эскиза возвращается во вложенном THUMBNAIL. Может возвращать эскизы в формате TIFF. Больше нет ограничения максимальной длины возвращаемых значений (но всю память выработать не получится). |
| 4.3.0 | Если в PHP есть поддержка mbstring, кодировка пользовательского комментария может быть автоматически изменена. Если пользовательский комментарий представлен в кодировках Unicode или JIS, эти кодировки будут автоматически преобразованы в соответствии с ini-настройками в php.ini |
| 4.3.0 | Если изображение содержит какие-либо данные в IFD0, то COMPUTED будет содержать порядок байт ByteOrderMotorola со значением 0 для little-endian (intel) и 1 для big-endian (motorola). Также, COMPUTED и UserComment больше не содержат первое значение copyright, если при определении типа данных файла возникла ошибка. |
Пример #1 Пример использования exif_read_data()
<?php
echo "test1.jpg:<br />\n";
$exif = exif_read_data('tests/test1.jpg', 'IFD0');
echo $exif===false ? "Не найдено данных заголовка.<br />\n" : "Изображение содержит заголовки<br />\n";
$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";
}
}
?>
Первых вызов завершается неудачей, так как в заголовках изображения нет информации.
Результатом выполнения данного примера будет что-то подобное:
test1.jpg: No header data found. 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