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

getATimeメソッドは、SplFileObjectクラスのインスタンスが表すファイルが最後にアクセスされた時刻を取得するメソッドです。このメソッドは、ファイルの内容が読み込まれたり、情報が参照されたりした最終時刻を、Unixタイムスタンプ形式の整数値として返します。Unixタイムスタンプとは、1970年1月1日00:00:00 UTCからの経過秒数を表す数値であり、PHPのdate()関数などを使って人間が読みやすい形式に変換できます。

このメソッドは引数を必要とせず、常にファイルオブジェクトが指し示すファイルのアクセス時刻に関する情報を提供します。例えば、特定のファイルがいつ最後に開かれたか、あるいは内容が読み込まれたかを確認したい場合に、SplFileObjectオブジェクトを作成し、そのオブジェクトからgetATimeメソッドを呼び出すことで、簡単にその情報を取得できます。もしファイルへのアクセス時刻の取得に失敗した場合は、このメソッドはブール値のfalseを返しますので、エラーハンドリングを行うことが推奨されます。

SplFileObjectクラスは、PHPでファイルをオブジェクト指向的に操作するための非常に便利な機能を提供しており、getATimeメソッドはその中の一つとして、ファイルのメタデータ（付帯情報）を取得する際に役立ちます。システム内でファイルがいつ最後に利用されたかを追跡したり、特定の条件に基づいてファイルの処理を決定したりするシナリオで特に有用なメソッドです。

Copy
1<?php
2$filePath = 'example.txt';
3file_put_contents($filePath, 'This is a sample file.');
4
5$fileObject = new SplFileObject($filePath, 'r');
6$accessTime = $fileObject->getATime();
7
8echo $accessTime . "\n";
9echo date('Y-m-d H:i:s', $accessTime) . "\n";
10
11unlink($filePath);
12?>

引数なし

引数はありません

int|false

SplFileObject::getATime()は、ファイルの最終アクセス時刻をUNIXタイムスタンプ形式の整数で返します。エラーが発生した場合はfalseを返します。