【PHP8.x】closedir関数の使い方

作成日: 更新日:

closedir関数は、PHPにおいてopendir()関数で開いたディレクトリハンドルを閉じ、関連するシステムリソースを解放するために実行する関数です。ファイルシステム上のディレクトリの内容を読み取る際、まずopendir()関数で対象のディレクトリを開き、その操作によって得られる特別な識別子であるディレクトリハンドルを使用します。このclosedir()関数は、ディレクトリに対する一連の操作が完了した後に、開かれたディレクトリを閉じる役割を担います。

この関数を使用する主な目的は、プログラムが使用していたメモリやファイル記述子といったシステムリソースを適切に解放することにあります。これにより、リソースの無駄遣いを防ぎ、システムの安定性を保つことができます。特に、多数のディレクトリを繰り返し処理する場合や、長時間稼働するアプリケーションでは、リソースリークを防ぐ上でclosedir()によるリソースの解放が非常に重要となります。

closedir関数は、引数として閉じたいディレクトリに対応する有効なディレクトリハンドルを一つだけ受け取ります。そして、ディレクトリを閉じる処理が正常に完了した場合には、戻り値として何も値(void)を返しません。これは、PHPが処理の成功を示す方法の一つです。opendir()関数、readdir()関数、rewinddir()関数といった他のディレクトリ操作関数と組み合わせることで、ディレクトリの内容を安全かつ効率的に管理し、操作することができます。

基本的な使い方

構文(syntax)

<?php
$dir_handle = opendir('.');
if (is_resource($dir_handle)) {
    closedir($dir_handle);
}
?>

引数(parameters)

resource $dir_handle

  • resource $dir_handle: opendir() 関数によって返されたディレクトリハンドル

戻り値(return)

bool

ディレクトリハンドルを閉じる操作が成功した場合は true を、失敗した場合は false を返します。

【PHP8.x】closedir関数の使い方 | いっしー@Webエンジニア