【PHP8.x】fileatime関数の使い方

fileatime関数は、指定されたファイルの最終アクセス時刻を取得する処理を実行する関数です。この関数は、引数としてファイルへのパスを文字列で受け取り、そのファイルが最後に読み込みなどのアクセスをされた日時を返します。戻り値は、成功した場合はUnixタイムスタンプ形式の整数となり、これは1970年1月1日 00:00:00 UTCからの経過秒数を表します。ファイルが存在しないなどの理由で時刻の取得に失敗した場合は、falseを返します。注意点として、パフォーマンス向上のため、関数の結果はキャッシュされることがあります。したがって、最新の情報を確実に取得するためには、この関数を呼び出す前にclearstatcache()関数を実行してキャッシュをクリアする必要があります。また、使用しているオペレーティングシステムやファイルシステムの設定によっては、アクセス時刻が更新されない場合があるため、その環境では期待通りの結果が得られない可能性があります。ファイルの最終更新時刻を取得する場合はfilemtime関数、inodeの最終変更時刻を取得する場合はfilectime関数を使用します。

<?php
// 構文: fileatime ( string $filename ) : int|false

// 対象となるファイルのパスを指定します
$filename = 'path/to/your/file.txt';

// fileatime関数を呼び出し、ファイルの最終アクセス時刻を取得します。
// 成功した場合はUNIXタイムスタンプ（整数）、失敗した場合は false を返します。
$lastAccessTime = fileatime($filename);
?>

string $filename

• string $filename: ファイルのパスを指定する文字列

int|false

fileatime関数は、指定されたファイルの最終アクセス時刻をUNIXタイムスタンプ形式の整数で返します。エラーが発生した場合はfalseを返します。