« imagedashedline
imageellipse »

imagedestroy

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

imagedestroy — 画像を破棄する

警告

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

説明

#[\Deprecated(
    since: '8.5',
    message: "as it has no effect since PHP 8.0",
)]

function 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);
?>

関連キーワード:
画像   imagedestroy   image   破棄   GdImage   推奨   since   リソース   メモリ   解放   imagecreatetruecolor   期待   imagedashedline   imageellipse   Image   非推奨   Deprecated   message   effect   保持   拡張   明示   クローズ   履歴   インスタンス
関連する関数・ページ:
function.ps-close-image   function.imagesx   function.imagesy   function.ps-open-image-file   function.ps-open-memory-image   function.imageaffine