array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.imagedestroy.php', 1 => 'imagedestroy', 2 => '画像を破棄する', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD および Image 関数', ), 'prev' => array ( 0 => 'function.imagedashedline.php', 1 => 'imagedashedline', ), 'next' => array ( 0 => 'function.imageellipse.php', 1 => 'imageellipse', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', '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 — 画像を破棄する

警告

この関数は PHP 8.5.0 で 非推奨になります。この関数に頼らないことを強く推奨します。

説明

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

注意:

この関数を実行しても何も起こりません。PHP 8.0.0 より前のバージョンでは、この関数はリソースを閉じるのに使われていました。

PHP 8.0.0 より前のバージョンでは、 imagedestroy() は画像 image を保持するメモリを解放していました。 PHP 8.0.0 以降のバージョンでは、 GD 拡張モジュールはリソースの代わりにオブジェクトを使うようになったので、 オブジェクトは明示的にクローズできなくなっています。

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

戻り値

常に true を返します。

変更履歴

バージョン 説明
8.5.0 この関数は推奨されなくなりました。
8.0.0 この関数は何も処理を行わなくなりました。
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な gd resource が期待されていました。

例

例1 PHP 8.0.0 より前のバージョンでの imagedestroy() の使用例

<?php
// 100 x 100 の画像を作成します
$im = imagecreatetruecolor(100, 100);

// 画像を変更したり保存したりします

// 画像をメモリから開放します
imagedestroy($im);
?>