画像を破棄する

# imagedestroy

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

imagedestroy — 画像を破棄する

警告

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

### 説明

#[\Deprecated]
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);
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open