【PHP8.x】getMTimeメソッドの使い方

getMTimeメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

getMTimeメソッドは、FilesystemIteratorオブジェクトが現在ポイントしているファイルまたはディレクトリの最終更新時刻(Modification Time)を取得するメソッドです。

このメソッドは、ファイルシステム上の指定された項目が最後に変更された日時をUnixタイムスタンプとして返します。Unixタイムスタンプとは、1970年1月1日00:00:00協定世界時(UTC)から現在までの経過秒数を表す整数値のことです。取得したタイムスタンプは、PHPのdate()関数など他の日付・時刻関連関数と組み合わせることで、人間が読みやすい形式に変換できます。

システムエンジニアがファイルの更新状況を監視したり、ウェブアプリケーションでキャッシュの有効期限を管理したりする際に非常に有用です。例えば、ファイルの更新時刻に基づいてキャッシュをクリアするロジックを実装する際に利用されます。ファイルのアクセス権限の問題など、何らかの理由で更新時刻を取得できなかった場合は、falseが返される可能性がありますので、戻り値の確認は重要です。このメソッドを利用することで、ファイルやディレクトリのライフサイクルにおける重要な情報にプログラムからアクセスできるようになります。

構文(syntax)

1<?php
2$iterator = new FilesystemIterator(__DIR__);
3
4$iterator->rewind();
5
6$lastModifiedTime = 0;
7
8if ($iterator->valid()) {
9    $lastModifiedTime = $iterator->getMTime();
10}

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

FilesystemIterator::getMTime は、イテレータが現在指しているファイルまたはディレクトリの最終更新時刻をUnixタイムスタンプ(秒単位の整数)で返します。