PHPのrmdir()関数とは？空のディレクトリを削除する使い方を解説

PHPのrmdir()関数は、空のディレクトリ（フォルダ）を削除するための組み込み関数です。この関数を実行するには、スクリプトが対象ディレクトリを削除できる適切な権限を持っている必要があります。また、ディレクトリ内にファイルやサブディレクトリが残っていると削除に失敗する点にも注意しましょう。

構文

rmdir(dir, context)

パラメータ

• dir − 削除したいディレクトリへのパスを指定します（必須）。

• context − ストリームの動作を制御するためのコンテキストを指定します（省略可能）。ストリームコンテキストを使うことで、ファイルシステム操作の挙動を細かく設定できます。

戻り値

rmdir()関数は、削除に成功した場合は TRUE を返し、失敗した場合は FALSE を返します。失敗時には E_WARNING レベルの警告も発生します。

使用例1

次の例では、「amit」という名前のディレクトリを削除し、失敗した場合にメッセージを表示しています。

<?php
    $dir_path = "amit";
    if(!rmdir($dir_path)) {
        echo("Could not remove " . $dir_path);
    }
?>

出力結果

TRUE

続いて、もう一つの例を見てみましょう。

使用例2

まず mkdir() 関数で新しいディレクトリを作成し、その直後に rmdir() 関数で削除する流れです。

<?php
    // 「documents」ディレクトリを作成
    mkdir('documents');
    $dir = "documents";
    
    // rmdir()を使ってディレクトリを削除
    rmdir($dir);
?>

出力結果

TRUE

注意点

rmdir()関数で削除できるのは空のディレクトリのみです。中にファイルやサブディレクトリが含まれている場合は、あらかじめ unlink() 関数などでそれらをすべて削除しておく必要があります。また、Webサーバーの実行ユーザーが対象ディレクトリに対して十分な書き込み権限を持っているかどうかも確認してください。