array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imagedestroy.php', 1 => 'imagedestroy', 2 => 'Löscht ein Bild', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD- und Image-Funktionen', ), 'prev' => array ( 0 => 'function.imagedashedline.php', 1 => 'imagedashedline', ), 'next' => array ( 0 => 'function.imageellipse.php', 1 => 'imageellipse', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/image/functions/imagedestroy.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagedestroy

(PHP 4, PHP 5, PHP 7, PHP 8)

imagedestroy — Löscht ein Bild

Beschreibung

imagedestroy(GdImage $image): bool

Hinweis:

Diese Funktion hat keine Auswirkung. Vor PHP 8.0.0 wurde sie verwendet, um die Ressource zu schließen.

Vor PHP 8.0.0 gibt imagedestroy() den durch die image-Ressource belegten Speicher wieder frei. Seit PHP 8.0.0 verwendet die GD-Erweiterung Objekte anstelle von Ressourcen, und Objekte können nicht explizit geschlossen werden.

Parameter-Liste

image

Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 Diese Funktion ist jetzt ein NOP.
8.0.0 image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-Ressource erwartet.

Beispiele

Beispiel #1 Verwendung von imagedestroy() vor PHP 8.0.0

<?php
// erzeuge ein 100 x 100 Bild
$im = imagecreatetruecolor(100, 100);

// verändere oder speichere das Bild

// gibt den durch das Bild belegten Speicher frei
imagedestroy($im);
?>