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

getMTimeメソッドは、ファイルやディレクトリの最終更新時刻（Modification Time）を取得するメソッドです。このメソッドは、PHPの標準ライブラリ（Standard PHP Library、通称SPL）に含まれるSplFileInfoクラスに属しており、ファイルシステムに関する詳細な情報をオブジェクト指向的に効率良く扱うための機能を提供します。具体的には、対象のファイルが最後に書き込まれたり変更されたりした日時をUNIXタイムスタンプという整数値で返します。UNIXタイムスタンプとは、1970年1月1日0時0分0秒（協定世界時、UTC）からの経過秒数を表す数値であり、この値をdate()関数などのPHPのタイムスタンプ操作関数と組み合わせることで、人間が理解しやすい形式の日時に変換することができます。

このメソッドを利用することで、ファイルがいつ更新されたのかを確認したり、複数のファイルの更新順序を比較したりすることが可能になります。例えば、ウェブサイトのキャッシュファイルの有効期限を判断したり、設定ファイルの変更を監視したりするような場面で非常に役立ちます。

ファイルが存在しない場合や、アクセス権がないなどの理由で最終更新時刻の取得に失敗した場合には、このメソッドはfalseを返します。そのため、メソッドの返り値をチェックし、falseでないことを確認してから処理を進めることが重要です。ファイルシステムの健全性を確認したり、アプリケーションの動作を制御したりする上で、getMTimeメソッドは不可欠な基本的な機能の一つと言えるでしょう。

Copy
1<?php
2$fileInfo = new SplFileInfo('path/to/your/file.txt');
3$lastModifiedTime = $fileInfo->getMTime();
4?>

引数なし

引数はありません

int|false

SplFileInfo::getMTime() は、ファイルの最終更新時刻をUnixタイムスタンプ（1970年1月1日午前0時からの経過秒数）として整数で返します。ファイルが存在しない場合や読み取り権限がない場合は false を返します。