PHPでディレクトリを作成・操作する方法！初心者向けにmkdir・rmdir・scandirをやさしく解説

PHP でディレクトリを作成・操作する方法（mkdir, rmdir, scandir）

先生と生徒の会話形式で理解しよう

生徒

「PHPでフォルダを作ったり、中のファイルを調べたり、削除したりできますか？」

先生

「はい、できますよ。PHPにはmkdir・rmdir・scandirというディレクトリ（フォルダ）を扱うための関数があります。」

生徒

「ディレクトリって、パソコンの中のフォルダのことですよね？」

先生

「そのとおりです！今回はそのディレクトリをPHPで作ったり、調べたり、削除したりする方法を、プログラミング初心者にもわかりやすく説明していきます。」

1. ディレクトリとは何かを知ろう

プログラミングの世界で頻繁に登場する「ディレクトリ（directory）」。難しく聞こえるかもしれませんが、その正体は私たちが普段WindowsやMac、スマートフォンで使っている「フォルダ」と全く同じものです。

ファイルが増えてくると、「画像」「ドキュメント」「設定用」といった具合に種類ごとに整理したくなりますよね。この「ファイルを整理するための入れ物」を、ITの専門用語ではディレクトリと呼びます。

身近な例えでイメージしてみよう：

ファイル： ノートに書いた「1ページ分のメモ」
ディレクトリ： そのメモを綴じておく「バインダー」や「引き出し」

PHPというプログラミング言語を使うと、このディレクトリを「自動」で操作できるようになります。たとえば、以下のようなイメージです。


<?php
// PHPで「2026年_写真保存用」という名前のディレクトリ（フォルダ）を
// 作成するイメージをコードで表すとこのようになります
$folder_name = "2026年_写真保存用";

echo "「" . $folder_name . "」というディレクトリを作成し、ファイルを整理します。";
?>

手動で右クリックして「新規フォルダ作成」をする代わりに、PHPプログラムがあなたの代わりにディレクトリを作ったり、中身をチェックしたりしてくれるのです。これにより、大量のデータを扱うシステムでも、迷子にならないようにきれいに整理整頓することが可能になります。

2. mkdir関数でディレクトリを作成する方法

PHPで新しくフォルダを作りたいときは、mkdir（メイク・ディレクトリ）関数を使います。これは、パソコンのデスクトップで「右クリック＞新規作成＞フォルダ」と操作するのを、プログラムに代行させる命令です。

まずは、最もシンプルで安全な書き方を見てみましょう。プログラミング未経験の方でも、以下のコードをコピーして実行するだけでディレクトリが作成できます。


<?php
// 作成したいフォルダの名前を決める
$directory_name = "new_folder";

// すでに同じ名前のフォルダがないかチェックする
if (!is_dir($directory_name)) {
    // フォルダを作成する（mkdirを実行）
    if (mkdir($directory_name, 0777)) {
        echo "「" . $directory_name . "」というフォルダを無事に作成しました！";
    } else {
        echo "エラー：フォルダの作成に失敗しました。";
    }
} else {
    // すでに存在する場合のメッセージ
    echo "「" . $directory_name . "」は、すでに存在しています。";
}
?>

ここがポイント！

is_dir関数： 同じ名前のフォルダがすでにある場合、mkdirを実行するとエラーになってしまいます。事前に「ないこと」を確認するのがプロの書き方です。
パーミッション（0777）： mkdirの2番目の設定で、フォルダの「読み書き権限」を指定できます。Webサーバーで動かす際に「書き込めない！」というトラブルを防ぐための重要な数値です。
再帰的作成： mkdir("a/b/c", 0777, true)のように、3番目の設定にtrueを入れると、深い階層のフォルダも一気に作れて便利です。

この基本を押さえておけば、ユーザーが会員登録した瞬間にその人専用の画像保存フォルダを自動で作る、といった便利なシステムも簡単に実装できるようになります。

3. scandir関数で中身を確認する

scandir（スキャンディア）関数は、指定したディレクトリの中にあるファイルやサブディレクトリの一覧を配列として取得する関数です。


<?php
$files = scandir("example");
foreach ($files as $file) {
    echo $file . "\n";
}
?>

scandirはとても便利ですが、「.（ドット）」と「..（ドットドット）」という特別な記号も一緒に表示されるので注意してください。

.は「今のディレクトリ」
..は「一つ上の階層のディレクトリ」

4. rmdir関数でディレクトリを削除する方法

rmdir（アール・エム・ディー・アイ・アール）関数は、空のディレクトリを削除するために使います。中にファイルがあると削除できません。


<?php
$dir = "example";
if (is_dir($dir)) {
    rmdir($dir);
    echo "ディレクトリを削除しました。";
} else {
    echo "ディレクトリが見つかりません。";
}
?>

中にファイルや他のフォルダがある場合は、先にそれらを削除する必要があります。初心者はまず「空のフォルダ」の削除から試してみるのが安心です。

5. よくあるつまずきポイントと対策

パーミッションエラー：フォルダを作れない・消せないときは、パソコンやサーバーの「書き込み権限」が原因のことが多いです。
すでに存在している：同じ名前のフォルダがあると、mkdirでエラーになります。is_dirで確認しましょう。
空でないディレクトリ：rmdirは空でないと削除できません。中のファイルをすべて削除する処理が必要です。

6. 応用編：ディレクトリ内のファイルをすべて削除する

中にファイルがあるディレクトリを削除したい場合は、scandirでファイル一覧を取得し、unlinkで削除してからrmdirを実行します。


<?php
$dir = "example";
if (is_dir($dir)) {
    $files = scandir($dir);
    foreach ($files as $file) {
        if ($file !== "." && $file !== "..") {
            unlink($dir . "/" . $file);
        }
    }
    rmdir($dir);
    echo "フォルダと中身を削除しました。";
}
?>

これは少し難しいですが、実務ではよく使われる処理です。初心者の方はまず動作を確認して、徐々に理解を深めていきましょう。

7. PHPでディレクトリを操作する場面とは？

PHPでフォルダ（ディレクトリ）を扱うシーンは意外と多くあります。たとえば：

画像のアップロード時にフォルダを自動作成
ユーザーごとのデータ保存場所を用意
定期的に古いファイルを削除するバッチ処理
管理画面からフォルダの中身を確認する

このように、mkdir・scandir・rmdirを使いこなすことで、PHPのファイル管理がグッとレベルアップします。

まとめ

PHPでディレクトリを操作する方法は、初心者が最初につまずきやすい部分ですが、この記事で学んだように基礎となる関数をしっかり理解すれば確実に扱えるようになります。とくに、mkdirで新しいフォルダを生成する仕組み、scandirでフォルダの中身を一覧として取得する方法、そしてrmdirで安全にディレクトリを削除する流れは、ファイル管理を行ううえで欠かせない重要な操作です。これらを適切に組み合わせることで、画像管理やユーザーデータ管理といった実用的な処理にも応用できるようになります。

また、ディレクトリを扱う際には、書き込み権限の確認や「空でないディレクトリは削除できない」という基本ルールを忘れないことが大切です。実務では多くのアプリケーションで自動的にフォルダが生成されたり、不要なデータが削除されたりするため、今回の知識はPHP開発全体で役立ちます。特に、is_dirやunlinkを組み合わせて状態を判断しながら処理を進めることで、安全にディレクトリ操作を行うことができます。

以下は今回の内容をふり返る意味で、基本的なディレクトリ操作をひとまとめにしたサンプルコードです。実際の開発ではこれを応用して、ユーザーごとにフォルダを作成したり、自動的に古いファイルを整理したりする機能に発展させることができます。

サンプルプログラムまとめ


<?php
$dir = "sample_dir";

// ディレクトリがなければ作成
if (!is_dir($dir)) {
    mkdir($dir);
    echo "新しいフォルダを作成しました。\n";
}

// フォルダの一覧を確認
$items = scandir($dir);
foreach ($items as $item) {
    echo "中身：" . $item . "\n";
}

// 中身を削除してからフォルダを削除
foreach ($items as $item) {
    if ($item !== "." && $item !== "..") {
        unlink($dir . "/" . $item);
    }
}
rmdir($dir);
echo "フォルダと中身を安全に削除しました。";
?>

このコードでは、フォルダの作成・確認・削除までの流れをひとつの処理として確認できます。ディレクトリ操作はファイルアップロードやキャッシュ管理など幅広い用途で必要となるため、確実に身につけておくと開発の幅が大きく広がります。初心者でも、ひとつひとつの動作を確認しながら学ぶことで理解が深まり、より実践的な処理にも対応できるようになります。

先生と生徒の振り返り会話

生徒
「今日の内容で、フォルダを作ったり中を調べたり、全部PHPでできることがわかりました。mkdirとscandirとrmdirの役割がはっきり見えてきました！」

先生
「その理解はとても良いですね。ディレクトリ操作はアプリケーションでよく使うので、今回の知識は必ず役に立ちますよ。特に、scandirで一覧を取得してから内容を処理する流れは実務でもよく使います。」

生徒
「フォルダの中が空じゃないとrmdirが失敗する理由もよくわかりました。unlinkで中身を削除してから実行するのも勉強になりました。」

先生
「とても良いですね。実際の開発でもまず状況を確認してから処理を進めるのが大切なので、今日学んだ流れをしっかり覚えておきましょう。」

生徒
「はい！次はもっと応用的なディレクトリ操作にも挑戦してみたいです！」

ハローワーク講師による直接指導【PHP実務設計実践セミナー】