exif_thumbnail
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
exif_thumbnail — Liest das eingebettete Miniaturbild eines Bildes aus
Beschreibung
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
- exif_read_data() - Liest die EXIF-Header einer Bilddatei aus
- image_type_to_mime_type() - Get Mime-Type for image-type returned by getimagesize, exif_read_data, exif_thumbnail, exif_imagetype