exif_imagetype
exif_tagname
Exif Funktionen
PHP Manual

# exif_read_data

(PHP 4 >= 4.2.0, PHP 5)

exif_read_data — Liest die EXIF-Header von JPEG oder TIFF aus.

### Beschreibung

array exif_read_data ( string `$filename` [, string `$sections` [, bool `$arrays` [, bool `$thumbnail` ]]] )

exif_read_data() liest die EXIF-Header aus einer JPEG- oder TIFF-Bilddatei aus. Auf diese Weise kann man die Metadaten auslesen, die mit Digitalkameras erzeugt wurden.

Exif-Header kommen normalerweise bei JPEG/TIFF-Bildern vor, die von Digitalkameras gemacht wurden. Leider hat jeder Kamerahersteller eine andere Vorstellung davon, wie man die Bilder beschreibt. Man kann sich also nicht darauf verlassen, das ein bestimmter Exif-Header vorhanden ist.

Height und Width werden genauso wie getimagesize() berechnet. Diese Werte dürfen also nicht Teil von irgendwelchen Headern sein, die zurückgegeben werden. Ferner ist html ein Höhen/Breiten-Textstring für den Gebrauch in normalem HTML.

Wenn ein Exif-Header ein Copyrightvermerk beinhaltet, kann dieser selbst aus zwei Werten bestehen. Da die Lösung im Exif 2.10 Standard nicht konsistent ist, liefert der COMPUTED-Bereich die beiden Einträge Copyright.Photographer und Copyright.Editor, während der IFD0-Bereich aus einem Byte-Array besteht, der die beiden Werte duch ein NULL-Zeichen trennt. Wenn der Datentyp falsch ist, ist nur der erste Eintrag vorhanden (normales Verhalten von Exif). COMPUTED beinhaltet auch ein Copyright-Eintrag. Dieser entspricht entweder dem originalen Copyright-String oder er besteht aus einer kommaseparierten Liste von Foto- und Herausgeber-Copyright.

Der Tag UserComment besitzt das gleiche Problem, wie das Copyright-Tag. Er kann zwei Werte speichern. Als erstes die benutze Kodierung und als zweites den Wert selbst. Wenn dem so ist, enthält der IFD-Bereich die Kodierung oder ein Byte-Array. Der COMPUTED-Bereich speichert die beiden Einträge UserCommentEncoding und UserComment. Der Eintrag UserComment ist in beiden Fällen verfügbar. Er sollte also dem Eintrag im IFD0-Bereich vorgezogen werden.

exif_read_data() validiert auch EXIF-Datentags entsprechend der EXIF-Spezifikationen (» http://exif.org/Exif2-2.PDF, Seite 20).

> Hinweis: Windows ME/XP können beide beim Anschließen einer Kamera die Exif-Header verwerfen. Mehr Informationen dazu sind unter » http://www.canon.co.jp/Imaging/NOTICE/011214-e.html zu finden.

### Parameter-Liste

`filename`

  Der Name der zu lesenden Bilddatei. Dieser darf keine URL sein.

`sections`

  Ist eine kommaseparierte List von Bereichen, die in der Datei vorhanden sein muss, um das Rückgabe-array zu erzeugen. Wenn keine der geforderten Bereiche gefunden werden kann, wird `FALSE` zurückgegeben.

  FILE | FileName, FileSize, FileDateTime, SectionsFound
  COMPUTED | html, Width, Height, IsColor und andere, wenn vorhanden. Height und Width werden genauso wie getimagesize() berechnet. Diese Werte dürfen also nicht Teil von irgendwelchen Headern sein, die zurückgegeben werden. Ferner ist html ein Höhen/Breiten-Textstring für den Gebrauch in normalem HTML.
  ANY_TAG | Irgendwelche Informationen, die ein Tag besitzen, wie z.B. IFD0, EXIF, ...
  IFD0 | Alle IFD0-Daten mit Tag. In normalen Bilddateien beinhalten diese Bildgröße usw.
  THUMBNAIL | Eine Datei sollte ein Miniaturbild enthalten, wenn es einen zweiten IFD besitzt. Alle Informationen mit Tags über das eingebettete Miniaturbild werden in diesem Bereich gespeichert.
  COMMENT | Kommentarheader des JPEG-Bildes.
  EXIF | Der EXIF-Bereich ist ein Unterbereich von IFD0. Er enthält detailliertere Information über das Bild. Die meisten dieser Einträge beziehen sich auf die Digitalkamera.

`arrays`

  Definiert ob jeder Bereich ein Array wird oder nicht. Die `sections` COMPUTED, THUMBNAIL und COMMENT werden immer zu Arrays, da die Namen der Werte mit denen anderer Bereiche kollidieren können.

`thumbnail`

  Bei `TRUE` wird das Miniaturbild ausgelesen, ansonsten nur die Daten der Tags.

### Rückgabewerte

Gibt ein assoziatives array zurück, bei dem der Arrayindex den Headernamen entspricht und der Arraywert die Werte enthält, die mit diesen Headern in Verbindung stehen. Wenn keine Daten zurückgeliefert werde können, liefert exif_read_data() `FALSE`.

### ChangeLog

Version | Beschreibung
--- | ---
4.3.0 | Kann alle eingebetteten IFD-Daten inklusive Arrays (werden auch als solche zurückgegeben) lesen. Sowohl die Größe des eingebetteten Miniaturbildes wird im Unterbereich von THUMBNAIL zurückgegeben als auch Miniaturbilder im TIFF-Format. Es gibt auch keine Längenbeschränkung mehr für die Rückgabewerte (solange das Speicherlimit nicht erreicht wird).
4.3.0 | Wenn PHP mbstring unterstützt, können die Benutzerkommentare automatisch umkodiert werden. Benutzerkommentare in Unicode oder JIS werden automatisch in den entsprechenden exif-Initwert der php.ini umkodiert.
4.3.0 | Wenn das Bild irgendeinen IFD0-Wert hat, enthält der Bereich COMPUTED einen Eintrag ByteOrderMotorola, welcher auf 0 für little-endian (intel) und 1 für big-endian (motorola) Bytefolge gesetzt ist. Bei einem falschen Datentyp, enthalten COMPUTED und UserComment auch nicht mehr nur den ersten Copyrighteintrag.

### Beispiele

Beispiel #1 exif_read_data() Beispiel

`<?php
echo "test1.jpg:<br />\n";
$exif = exif_read_data('tests/test1.jpg', 'IFD0');
echo $exif===false ? "Keine Headerdaten gefunden.<br />\n" : "Bild beinhaltet Header<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";
}
}
?>`

Der erste Aufruf schlägt fehl, da das Bild keine Headerinformationen hat.

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    test1.jpg:
    Keine Headerdaten gefunden.
    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

### Siehe auch

- exif_thumbnail()
- getimagesize()

exif_imagetype
exif_tagname
Exif Funktionen
PHP Manual