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

getATimeメソッドは、GlobIteratorオブジェクトが現在指しているファイルまたはディレクトリの最終アクセス時刻（access time）を取得するメソッドです。このメソッドを利用することで、特定のファイルやディレクトリが最後に読み込まれたり、実行されたりした日時を知ることができます。最終アクセス時刻は、そのファイルの内容が最後に更新された時刻（modification time）とは異なり、主にファイルの利用状況を把握するために用いられます。

戻り値としては、通常はUNIXタイムスタンプ形式の整数値が返されます。これは1970年1月1日00:00:00 UTCからの経過秒数で表されるため、日付や時刻として表示するには、PHPのdate関数などと組み合わせて使用する必要があります。例えば、長期間アクセスされていないファイルを特定し、システムの整理や最適化を行う際に、このメソッドは有用な情報を提供します。ただし、一部のファイルシステムやオペレーティングシステムの設定によっては、ファイルへのアクセス時刻が正確に記録されない場合がある点に注意が必要です。ファイルシステムの状態監視や、ファイルの利用頻度に基づいた処理を行う際に活用できます。

Copy
1<?php
2// このコード例を実行するには、スクリプトと同じディレクトリに一つ以上のファイルが存在する必要があります。
3// 例: touch('temp.txt'); とコマンドラインで実行してからこのスクリプトを実行すると動作を確認できます。
4$iterator = new GlobIterator(__DIR__ . '/*');
5
6foreach ($iterator as $file) {
7    // GlobIterator オブジェクトの現在の項目（ファイルまたはディレクトリ）の最終アクセス時刻を取得します。
8    // 戻り値はUnixタイムスタンプ（整数）です。
9    $accessTime = $iterator->getATime();
10
11    // 取得した時刻とファイル名を表示する例
12    echo "ファイル: " . $file->getFilename() . ", 最終アクセス時刻: " . date('Y-m-d H:i:s', $accessTime) . "\n";
13    
14    // 最初の項目のみを処理して終了します。
15    break; 
16}
17?>

引数なし

引数はありません

int

GlobIterator::getATimeメソッドは、ファイルが最後にアクセスされた時刻をUNIXタイムスタンプ形式で返します。