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

Copy
1<?php
2
3/**
4 * GlobIterator::getMTime メソッドを使用して、ファイルの最終更新時刻を取得するサンプル
5 *
6 * この関数は、指定されたパターンに一致するファイルを作成し、
7 * そのファイルの最終更新時刻をGlobIteratorを介して取得し、表示します。
8 */
9function demonstrateGlobIteratorGetMTime(): void
10{
11    // 一時ファイルを作成し、内容を書き込む
12    // このファイルに対して更新時刻をテストします
13    $tempFilePattern = sys_get_temp_dir() . '/temp_file_for_glob_*.txt';
14    $tempFileName = tempnam(sys_get_temp_dir(), 'glob_test_'); // 一意なファイル名を生成
15    if ($tempFileName === false) {
16        echo "エラー: 一時ファイルの作成に失敗しました。\n";
17        return;
18    }
19    file_put_contents($tempFileName, "これはテストファイルの内容です。\n");
20
21    echo "一時ファイルを作成しました: " . basename($tempFileName) . "\n";
22    echo "ファイルパス: " . $tempFileName . "\n";
23
24    try {
25        // GlobIterator を使用して、作成した一時ファイルを指定
26        // 注意: GlobIterator はパスパターンを引数に取ります。
27        // ここでは特定のファイルパスをパターンとして指定しています。
28        $iterator = new GlobIterator($tempFileName);
29
30        // イテレータが空でないか確認
31        if (!$iterator->valid()) {
32            echo "エラー: 指定されたパターンでファイルが見つかりませんでした。\n";
33            return;
34        }
35
36        // イテレータをループしてファイル情報を取得
37        foreach ($iterator as $fileInfo) {
38            // 現在のファイル情報の最終更新時刻をUnixタイムスタンプで取得
39            $mtime = $fileInfo->getMTime();
40
41            echo "---------------------------------------------------\n";
42            echo "ファイル名: " . $fileInfo->getFilename() . "\n";
43            echo "最終更新時刻 (Unixタイムスタンプ): " . $mtime . "\n";
44            // Unixタイムスタンプを人間が読める形式に変換して表示
45            echo "最終更新時刻 (人間が読める形式): " . date('Y-m-d H:i:s', $mtime) . "\n";
46            echo "---------------------------------------------------\n";
47        }
48    } catch (Exception $e) {
49        echo "エラーが発生しました: " . $e->getMessage() . "\n";
50    } finally {
51        // テスト終了後、作成した一時ファイルを削除してクリーンアップ
52        if (file_exists($tempFileName)) {
53            unlink($tempFileName);
54            echo "一時ファイルを削除しました: " . basename($tempFileName) . "\n";
55        }
56    }
57}
58
59// 関数を実行
60demonstrateGlobIteratorGetMTime();
61
62?>

PHP 8のGlobIterator::getMTimeメソッドは、ファイルシステム上のファイルやディレクトリの最終更新時刻を取得するために使用されます。このメソッドはGlobIteratorクラスに属しており、ファイルシステムを反復処理して特定のパターンに一致するファイル情報を取得する際に活用されます。

getMTimeメソッドは引数を一切必要としません。呼び出されると、対象のファイルが最後に変更された時刻をUnixタイムスタンプとして整数値で返します。Unixタイムスタンプとは、1970年1月1日 00:00:00 UTCからの経過秒数を表す数値です。

サンプルコードでは、まず一時ファイルを作成し、そのファイルのパスをGlobIteratorに渡してファイル情報オブジェクトを取得しています。foreachループでGlobIteratorを処理することで、一つ一つのファイル情報が$fileInfoオブジェクトとして得られます。この$fileInfoオブジェクトからgetMTime()メソッドを呼び出すことで、ファイルの最終更新時刻がUnixタイムスタンプ形式で取得できます。取得したタイムスタンプはそのままでは人間が読みにくいため、date()関数と組み合わせて「年-月-日 時:分:秒」のような、より分かりやすい形式に変換して表示しています。このメソッドは、ファイルの更新状況を監視したり、ファイルがいつ変更されたかを確認したりする場面で役立ちます。