PHPのfileatime()関数とは？使い方とサンプルコードをわかりやすく解説

PHPのfileatime()関数は、指定したファイルに最後にアクセス（読み取りなど）があった日時を取得するための組み込み関数です。取得できる値はUNIXタイムスタンプ形式で返され、ファイルへの最終アクセス時刻をプログラム内で扱えるようになります。ファイルが存在しない場合やアクセス権限がないなど、処理に失敗した場合はfalseを返します。

基本構文

fileatime ( file_path );

パラメータ

• file_path − 最終アクセス日時を調べたいファイルへのパスを指定します。相対パスでも絶対パスでも指定可能です。

戻り値

ファイルの最終アクセス時刻をUNIXタイムスタンプ（1970年1月1日00:00:00 UTCからの経過秒数）として返します。処理に失敗した場合はfalseを返します。

使用例：タイムスタンプで取得する

まずは、もっともシンプルな使い方です。「new.txt」というファイルの最終アクセス時刻をそのまま表示してみましょう。

<?php
    echo fileatime("new.txt");
?>

出力結果

1315416291

使用例：人間が読める形式の日付で表示する

UNIXタイムスタンプは数字だけなので、このままでは直感的に把握しにくいかもしれません。date()関数と組み合わせることで、「2024年5月1日 10:30:15」のような人間が理解しやすい形式に変換して表示できます。

<?php
    echo "ファイルの最終アクセス日時： ".date("Y年m月d日 H:i:s", fileatime("new.txt"));
?>

出力結果

ファイルの最終アクセス日時： 2011年09月07日 21:24:51

注意点

fileatime()関数を使う際には、いくつか知っておきたいポイントがあります。

• キャッシュの影響： PHPはファイル情報をキャッシュする仕組みがあるため、同一スクリプト内で同じファイルに対して繰り返し確認する場合は、clearstatcache()を実行してキャッシュをクリアすると正確な値を取得できます。

• atimeは更新されない場合がある： サーバー環境やOSの設定によっては、パフォーマンス向上のためファイルシステム側でアクセス時刻（atime）の更新が無効化されていることがあります。その場合、意図した値が得られない可能性がある点に注意してください。

• エラーの扱い： ファイルが存在しない場合、falseが返されるとともにE_WARNINGレベルのエラーが発生します。事前にfile_exists()で存在チェックを行うか、「@」演算子でエラー出力を抑制する方法もあります。

まとめ

fileatime()関数は、ファイルの最終アクセス日時をUNIXタイムスタンプで簡単に取得できる便利な関数です。date()関数と組み合わせれば見やすい日付形式での表示も可能です。ログ監視やキャッシュ管理など、ファイルの利用状況を把握したい場面で活用してみてください。