getimagesize
(PHP 4, PHP 5, PHP 7)
getimagesize — Ermittelt die Größe einer Grafik
Beschreibung
$filename
[, array &$imageinfo
] ) : array
Die Funktion getimagesize() ermittelt die Dimensionen der
übergebenen Grafik-Datei, sofern das Format unterstützt wird, und gibt diese zusammen mit dem Dateityp und einem
String aus Breite und Höhe zurück, der
innerhalb eines regulären HTML IMG-Tags verwendet
werden kann. Außerdem wird der entsprechende HTTP
Content-Type zurückgegeben.
getimagesize() kann im Parameter imageinfo
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. Statt dessen sollte eine für diesen Zweck entwickelte Lösung wie die Fileinfo-Extension 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 unterstützten Stream gelesen wird.
-
imageinfo -
Dieser optionale Parameter erlaubt es, erweiterte Informationen aus der Datei zu ermitteln. Momentan 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 » http://www.iptc.org/ Informationen in die APP13-Markierung. Sie können iptcparse() benutzen, um die binäre APP13-Markierung in ein lesbares Format zu übertragen.
Hinweis:
Der Parameter
imageinfounterstü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 Breite respektive Höhe der Grafik.
Hinweis:
Einige Formate enthalten keine oder mehrere Grafiken. In diesen Fällen ist getimagesize() möglicherweise nicht in der Lage, die Dimensionen 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 entsprechend des Typs der Grafik.
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. |
| 5.3.0 | Unterstützung für Icons hinzugefügt. |
| 5.2.3 |
Lesefehler erzeugen eine E_NOTICE statt einer
E_WARNING.
|
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);
}
?>
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 Miniaturbildes eines Bildes
- imagesx() - Ermittle die Bild-Breite
- imagesy() - Ermittle die Bild-Höhe
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-function.getimagesize.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.
