imagedestroy

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

imagedestroyLöscht ein Bild

Warnung

Diese Funktion ist seit PHP 8.5.0 als DEPRECATED (veraltet) markiert. Von der Verwendung dieser Funktion wird dringend abgeraten.

Beschreibung

#[\Deprecated]
function imagedestroy(GdImage $image): true

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 immer true zurück.

Changelog

Version Beschreibung
8.5.0 Diese Funktion wurde als veraltet eingestuft.
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);
?>