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

Copy
1<?php
2
3/**
4 * 指定されたディレクトリ内の各ファイルとディレクトリの最終更新時刻を表示します。
5 *
6 * @param string $directoryPath 検査するディレクトリのパス
7 * @return void
8 */
9function displayFileModificationTimes(string $directoryPath): void
10{
11    // ディレクトリが存在し、読み取り可能か確認
12    if (!is_dir($directoryPath)) {
13        echo "エラー: ディレクトリ '{$directoryPath}' が見つからないか、読み取れません。\n";
14        return;
15    }
16
17    echo "ディレクトリ: '{$directoryPath}' 内のアイテムの最終更新時刻:\n";
18    echo "--------------------------------------------------\n";
19
20    try {
21        // DirectoryIterator クラスを使用してディレクトリ内のアイテムを反復処理
22        // これにより、ディレクトリ内のファイルやサブディレクトリの情報を取得できます。
23        $iterator = new DirectoryIterator($directoryPath);
24
25        foreach ($iterator as $fileInfo) {
26            // 現在のアイテムが「.」または「..」である場合はスキップします。
27            // これらは現在のディレクトリと親ディレクトリを表し、通常は除外されます。
28            if ($fileInfo->isDot()) {
29                continue;
30            }
31
32            $filename = $fileInfo->getFilename();
33
34            // getMTime() メソッドで最終更新時刻（Unixタイムスタンプ）を取得します。
35            // 失敗した場合は false を返します。
36            $modificationTimestamp = $fileInfo->getMTime();
37
38            if ($modificationTimestamp !== false) {
39                // 取得したタイムスタンプを人間が読める「年-月-日 時:分:秒」形式に変換
40                $formattedTime = date('Y-m-d H:i:s', $modificationTimestamp);
41                echo "  {$filename}: {$formattedTime}\n";
42            } else {
43                echo "  {$filename}: 最終更新時刻を取得できませんでした。\n";
44            }
45        }
46    } catch (Exception $e) {
47        // DirectoryIterator の作成中にエラーが発生した場合 (例: 無効なパス)
48        echo "エラーが発生しました: " . $e->getMessage() . "\n";
49    }
50    echo "--------------------------------------------------\n";
51}
52
53// サンプルとして、このスクリプトが実行されている現在のディレクトリを指定します。
54// これにより、一時ファイルなどを作成する手間なく、動作を確認できます。
55$currentDirectory = __DIR__;
56displayFileModificationTimes($currentDirectory);
57
58?>

このPHPコードは、DirectoryIteratorクラスとgetMTime()メソッドを使用して、指定されたディレクトリ内のファイルやサブディレクトリの最終更新時刻を表示する方法を示しています。

まず、検査したいディレクトリのパスをDirectoryIteratorクラスに渡し、そのディレクトリ内のアイテムを一つずつ操作できるように準備します。その後、ループ処理で各ファイルやディレクトリの情報を取り出します。それぞれのアイテムに対してgetMTime()メソッドを呼び出すことで、そのアイテムが最後に更新された日時をUnixタイムスタンプ形式で取得できます。

getMTime()メソッドは引数を必要とせず、最終更新時刻を整数値（Unixタイムスタンプ）として返します。もし何らかの理由で更新時刻の取得に失敗した場合は、falseが返されるため、コードではその場合分けも考慮されています。取得したタイムスタンプは、date()関数と組み合わせることで、「年-月-日 時:分:秒」のような人間が読みやすい形式に変換され、画面に出力されます。このサンプルは、ファイルシステムの情報をプログラムで扱う際の基礎を理解するのに役立ちます。