imagedestroy

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

imagedestroy — Destroy an image

Warning

This function has been DEPRECATED as of PHP 8.5.0. Relying on this function is highly discouraged.

Description

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

Note:

This function has no effect. Prior to PHP 8.0.0, this function was used to close the resource.

Prior to PHP 8.0.0, imagedestroy() freed any memory associated with the image resource. As of 8.0.0, the GD extension uses objects instead of resources, and objects cannot be explicitly closed.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().

Return Values

Always returns true.

Changelog

VersionDescription
8.5.0This function has been deprecated.
8.0.0This function is a NOP now.
8.0.0image expects a GdImage instance now; previously, a valid gd resource was expected.

Examples

Example #1 Using imagedestroy() prior to PHP 8.0.0

<?php
// create a 100 x 100 image
$im = imagecreatetruecolor(100, 100);

// alter or save the image

// frees image from memory
imagedestroy($im);
?>