getimagesize
(PHP 4, PHP 5, PHP 7, PHP 8)
getimagesize — Liefert die Größe einer Grafik
Beschreibung
$filename, array &$image_info = null): array|false
Die Funktion getimagesize() ermittelt die Größe der
übergebenen Grafik, sofern das Format unterstützt wird, und gibt die
Abmessungen zusammen mit dem Dateityp und einer Zeichenkette aus
Breite und Höhe zurück, die innerhalb
eines regulären HTML-IMG-Tags verwendet
werden kann. Außerdem wird der entsprechende
HTTP-Content-Type zurückgegeben.
getimagesize() kann im Parameter
image_info weitere Informationen liefern.
Diese Funktion erwartet, dass filename eine gültige
Bilddatei ist. Wird eine Datei angegeben, die kein Bild enthält, kann sie
fälschlicherweise als Bild erkannt werden und die Funktion wird
erfolgreich ausgeführt, aber das Array kann unsinnige Werte enthalten.
getimagesize() sollte nicht verwendet werden, um zu überprüfen, ob eine gegebene Datei ein Bild enthält. Stattdessen sollte eine für diesen Zweck entwickelte Lösung wie die Erweiterung Fileinfo verwendet werden.
Hinweis: Beachten Sie, dass JPC und JP2 aus Komponenten mit verschiedener Farbtiefe bestehen können. In diesem Fall entspricht der Wert für "bits" dem höchsten gefundenen Wert. Des Weiteren können JP2-Dateien mehrere JPEG-2000-Codestreams enthalten. In diesem Fall gibt getimagesize() die Werte des ersten gefundenen Codestreams zurück.
Hinweis: Informationen über Icons werden für das Icon mit der höchsten Bitrate ermittelt.
Hinweis: GIF-Bilder bestehen aus einem oder mehreren Frames, wobei jeder Frame nur einen Teil des Bildes belegen kann. Die Größe des Bildes, die von getimagesize() gemeldet wird, ist die Gesamtgröße (ermittelt aus dem Logical Screen Descriptor).
Parameter-Liste
-
filename -
Die zu überprüfende Datei. Dabei kann es sich um eine lokale Datei oder, eine entsprechende Konfiguration vorausgesetzt, um eine entfernte Datei handeln, die über einen der unterstützten Streams gelesen wird.
-
image_info -
Dieser optionale Parameter erlaubt es, erweiterte Informationen aus der Datei zu ermitteln. Aktuell werden die verschiedenen JPG-APP-Markierungen als assoziatives Array zurückgegeben. Diese Markierungen werden von einigen Programmen verwendet um, Textinformationen in Grafiken zu speichern. Gebräuchlich ist die Einbettung von » IPTC-Informationen in die APP13-Markierung. Sie können iptcparse() verwenden, um die binäre APP13-Markierung in ein lesbares Format zu übertragen.
Hinweis:
Der Parameter
image_infounterstützt nur JFIF-Dateien.
Rückgabewerte
Gibt ein Array mit bis zu sieben Elementen zurück. Nicht alle Bildtypen
enthalten die Elemente channels und
bits.
Index 0 und 1 enthalten die Breite bzw. die Höhe des Bildes.
Hinweis:
Einige Formate enthalten keine oder mehrere Grafiken. In diesen Fällen ist getimagesize() möglicherweise nicht in der Lage, die Abmessungen zu ermitteln; der Rückgabewert für Breite und Höhe ist in diesen Fällen 0.
Index 2 ist eine der IMAGETYPE_XXX-Konstanten, die den Typ der Grafik angeben.
Index 3 ist eine Zeichenkette mit dem Attributen Breite und Höhe in der
Form height="yyy" width="xxx" zur Verwendung in einem
IMG-Tag.
mime entspricht dem MIME-Typ der Grafik. Diese
Information kann zur Auslieferung von Grafiken mit dem entsprechenden
HTTP-Content-type-Header dienen.
Beispiel #1 getimagesize() und MIME-Typ
<?php
$size = getimagesize($filename);
$fp = fopen($filename, "rb");
if ($size && $fp) {
header("Content-type: {$size['mime']}");
fpassthru($fp);
exit;
} else {
// Fehler
}
?>
channels hat für RGB-Grafiken den Wert 3, für CMYK den
Wert 4.
bits entspricht der Anzahl der Bits pro Farbe.
Für einige Bildformate kann die Angebe von channels und
bits irreführend sein. Beispielsweise nutzt
GIF immer drei Kanäle pro Pixel, aber die Anzahl der
Bits pro Pixel kann für ein animiertes GIF mit einer
globalen Farbtabelle nicht errechnet werden.
Gibt im Falle eines Fehlers false zurück.
Fehler/Exceptions
Wenn ein Zugriff auf die mit filename angegebene
Grafik nicht möglich ist, wird getimagesize() einen
Fehler der Stufe E_WARNING generieren. Bei einem
Lesefehler wird getimagesize() einen Fehler der Stufe
E_NOTICE hervorrufen.
Changelog
| Version | Beschreibung |
|---|---|
| 7.1.0 | Unterstützung für WebP hinzugefügt. |
Beispiele
Beispiel #2 getimagesize()-Beispiel
<?php
list($width, $height, $type, $attr) = getimagesize("img/flag.jpg");
echo "<img src=\"img/flag.jpg\" $attr alt=\"getimagesize() example\" />";
?>
Beispiel #3 getimagesize (URL)
<?php
$size = getimagesize("http://www.example.com/gifs/logo.gif");
// if the file name has space in it, encode it properly
$size = getimagesize("http://www.example.com/gifs/lo%20go.gif");
?>
Beispiel #4 getimagesize() mit Rückgabe von IPTC
<?php
$size = getimagesize("testimg.jpg", $info);
if (isset($info["APP13"])) {
$iptc = iptcparse($info["APP13"]);
var_dump($iptc);
}
?>
Anmerkungen
Hinweis:
Diese Funktion benötigt die GD-Bibliothek nicht.
Siehe auch
- image_type_to_mime_type() - Get Mime-Type for image-type returned by getimagesize, exif_read_data, exif_thumbnail, exif_imagetype
- exif_imagetype() - Ermittelt den Bildtyp
- exif_read_data() - Liest die EXIF-Header einer Bilddatei aus
- exif_thumbnail() - Liest das eingebettete Miniaturbild eines Bildes aus
- imagesx() - Ermittle die Bild-Breite
- imagesy() - Ermittle die Bild-Höhe
