【PHP8.x】RecursiveDirectoryIterator::getMTime()メソッドの使い方

Copy
1<?php
2
3/**
4 * RecursiveDirectoryIterator::getMTime の使用例
5 * 指定されたディレクトリ内のファイルやサブディレクトリの最終更新日時を取得します。
6 *
7 * この関数は、テスト用のディレクトリとファイルを作成し、それらを走査して
8 * 各要素の最終更新日時を取得・表示し、最後にクリーンアップを行います。
9 */
10function demonstrateRecursiveDirectoryIteratorGetMTime(): void
11{
12    // テスト用のディレクトリとファイルのパスを定義します
13    $baseDir = __DIR__ . '/recursive_mtime_test';
14    $subDir = $baseDir . '/subdir';
15    $file1 = $baseDir . '/file1.txt';
16    $file2 = $subDir . '/file2.txt';
17
18    // 既存のテストディレクトリがあれば、安全に削除して再作成します
19    if (is_dir($baseDir)) {
20        // RecursiveIteratorIterator を使って、子要素から順に削除
21        $cleanUpIterator = new RecursiveIteratorIterator(
22            new RecursiveDirectoryIterator($baseDir, RecursiveDirectoryIterator::SKIP_DOTS),
23            RecursiveIteratorIterator::CHILD_FIRST
24        );
25        foreach ($cleanUpIterator as $item) {
26            if ($item->isDir()) {
27                rmdir($item->getPathname());
28            } else {
29                unlink($item->getPathname());
30            }
31        }
32        rmdir($baseDir);
33    }
34
35    // テスト用のディレクトリとファイルを作成します
36    mkdir($baseDir);
37    mkdir($subDir);
38    file_put_contents($file1, 'これはファイル1の内容です。');
39    sleep(1); // タイムスタンプに差をつけるため、少し待機
40    file_put_contents($file2, 'これはファイル2の内容です。');
41    // ディレクトリ自身のタイムスタンプを設定 (例: 1時間前、2時間前)
42    touch($subDir, time() - 3600);
43    touch($baseDir, time() - 7200);
44
45    echo "--- ディレクトリとファイルの最終更新日時を取得します ---\n";
46
47    try {
48        // RecursiveDirectoryIterator を使用して、指定されたディレクトリを再帰的に走査します。
49        // SKIP_DOTS: "." と ".." エントリをスキップします。
50        $directoryIterator = new RecursiveDirectoryIterator($baseDir, RecursiveDirectoryIterator::SKIP_DOTS);
51
52        // RecursiveIteratorIterator と組み合わせて、ディレクトリの再帰的な走査を可能にします。
53        // SELF_FIRST: ディレクトリ自体をその子要素より先に処理します。
54        $iterator = new RecursiveIteratorIterator($directoryIterator, RecursiveIteratorIterator::SELF_FIRST);
55
56        // イテレータをループして、各ファイル/ディレクトリの情報を取得します
57        foreach ($iterator as $fileInfo) {
58            // RecursiveDirectoryIterator から得られる $fileInfo オブジェクトは SplFileInfo を継承しており、
59            // そのメソッドである getMTime() を使用して最終更新日時（Unixタイムスタンプ）を取得できます。
60            $mtime = $fileInfo->getMTime();
61
62            // Unixタイムスタンプを人間が読める日付形式に変換します
63            $formattedMtime = date('Y-m-d H:i:s', $mtime);
64
65            // ファイルまたはディレクトリのパスと更新日時を表示します
66            echo sprintf(
67                "%s [%s]: %s (Unixタイムスタンプ: %d)\n",
68                $fileInfo->getPathname(),
69                $fileInfo->isDir() ? 'DIR' : 'FILE', // 要素がディレクトリかファイルかを表示
70                $formattedMtime,
71                $mtime
72            );
73        }
74
75    } catch (RuntimeException $e) {
76        // ディレクトリが存在しないなどのエラーが発生した場合の処理
77        echo "エラーが発生しました: " . $e->getMessage() . "\n";
78    } finally {
79        // サンプル実行後、作成したファイルとディレクトリをクリーンアップします
80        echo "\n--- クリーンアップ中 ---\n";
81        // CHILD_FIRST: 子要素から先に処理することで、ファイルから削除し、最後に空のディレクトリを削除できます。
82        $cleanUpIterator = new RecursiveIteratorIterator(
83            new RecursiveDirectoryIterator($baseDir, RecursiveDirectoryIterator::SKIP_DOTS),
84            RecursiveIteratorIterator::CHILD_FIRST
85        );
86
87        foreach ($cleanUpIterator as $item) {
88            if ($item->isDir()) {
89                rmdir($item->getPathname());
90            } else {
91                unlink($item->getPathname());
92            }
93            echo "削除: " . $item->getPathname() . "\n";
94        }
95        // ベースディレクトリ自体も削除します
96        rmdir($baseDir);
97        echo "クリーンアップが完了しました。\n";
98    }
99}
100
101// 関数を実行して動作を確認します
102demonstrateRecursiveDirectoryIteratorGetMTime();

RecursiveDirectoryIterator::getMTimeは、PHPでファイルやディレクトリの最終更新日時を取得するためのメソッドです。このメソッドは、RecursiveDirectoryIteratorクラスのインスタンスが表すファイルやディレクトリについて、Unixタイムスタンプ形式の整数値で最終更新日時を返します。引数は不要です。

サンプルコードでは、まずテスト用のディレクトリとファイルをいくつか作成し、それぞれに異なる更新日時を設定しています。その後、RecursiveDirectoryIteratorとRecursiveIteratorIteratorを組み合わせて使用することで、指定されたベースディレクトリとその中のサブディレクトリ、さらにその中のファイルまで、すべての要素を再帰的に順に処理しています。

ループ内で各要素（ファイルまたはディレクトリ）が取得されるたびに、その要素を表すオブジェクトに対してgetMTime()メソッドを呼び出し、最終更新日時を表すUnixタイムスタンプを取得しています。取得したタイムスタンプは、date()関数を使って「YYYY-MM-DD HH:MM:SS」のような人間が読みやすい形式に変換され、ファイルの種類（ディレクトリかファイルか）とパス情報とともに表示されます。これにより、どの要素がいつ更新されたかを一覧で確認できます。最後に、作成したテスト用のディレクトリとファイルは安全に削除され、環境がクリーンアップされます。このコードは、システムのファイル構造を調べて最終更新情報を把握する際などに役立ちます。