exif_thumbnail

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

exif_thumbnail — Liest das eingebettete Miniaturbild eines Bildes aus

Beschreibung

exif_thumbnail(
    resource|string $file,
    int &$width = null,
    int &$height = null,
    int &$image_type = null
): string|false

exif_thumbnail() liest das eingebettete Miniaturbild eines Bildes aus.

Wenn man das Miniaturbild mit dieser Funktion ausliefern möchte, sollte man den Mimetype mit Hilfe der Funktion header() mitschicken.

Es kann passieren, dass exif_thumbnail() das Bild nicht erzeugen, aber dessen Größe bestimmen kann. In diesem Fall, ist der Rückgabewert false, obwohl width und height gesetzt sind.

Parameter-Liste

file
Der Ort der Bilddatei. Dies kann entweder ein Dateipfad oder eine Stream-Ressource sein.
width
Die Breite des gelieferten Miniaturbildes als Rückgabewert.
height
Die Höhe des gelieferten Miniaturbildes als Rückgabewert.
image_type
Der Bildtyp des gelieferten Miniaturbildes als Rückgabewert. Dieser ist entweder TIFF oder JPEG.

Rückgabewerte

Gibt das eingebettete Miniaturbild zurück oder false, wenn das Bild kein Miniaturbild enthält.

Changelog

Version Beschreibung
7.2.0 Der Parameter file unterstützt jetzt sowohl lokale Dateien als auch Stream-Ressourcen.

Beispiele

Beispiel #1 exif_thumbnail()-Beispiel

<?php
$image = exif_thumbnail('/Pfad/zum/Bild.jpg', $width, $height, $type);
if ($image!==false) {
header('Content-type: ' .image_type_to_mime_type($type));
echo $image;
exit;
} else {
// kein Miniaturbild vorhanden. Fehler wird hier verarbeitet
echo 'Kein Miniaturbild verfügbar';
}
?>

Anmerkungen

Hinweis: Wird file verwendet, um einen Stream an diese Funktion zu übergeben, dann muss der Stream durchsuchbar sein. Es ist zu beachten, dass sich die Position des Dateizeigers nicht ändert, nachdem diese Funktion aufgerufen wurde.

Siehe auch