PHPでファイルの最終更新時刻を取得する方法　filemtime関数の詳細解説

PHPでファイルの最終更新時刻を取得するためのfilemtime関数の使い方について、具体的なサンプルプログラムを交えて解説します。

PHPでファイルの最終更新時刻を取得したいのですが、どうすればいいでしょうか？

PHPにはfilemtimeという関数があり、この関数を使うことでファイルの最終更新時刻を簡単に取得できます。具体的な方法をサンプルプログラムと一緒に紹介しますね。

受講者数No.1！初心者からプロへ導く信頼のスクール

短期間で習得可能！未経験から実践力を磨く充実のプログラム

テックアカデミー 公式ページへ ≫

今なら無料相談でAmazonギフトカードがもらえる！

ファイルの最終更新時刻を確認する

PHPでは、filemtime関数を使うことで、指定したファイルの最終更新時刻を簡単に取得することができます。この関数は、ファイルが最後に変更された日時をUnixタイムスタンプ形式で返してくれるため、その時刻を使用してさまざまな操作を行うことが可能です。

例えば、ウェブサイト上のキャッシュの管理や、ファイルが一定期間内に更新されているかの確認など、ファイルの最終更新時刻を把握することで効率的な処理が可能になります。

ファイルの最終更新時刻を取得する基本的な手順は以下の通りです。

1. filemtime関数を使って、ファイルの更新時刻を取得します。
2. 取得したUnixタイムスタンプをdate関数を用いて、より読みやすい形式に変換します。
3. 取得した時刻を用いて、必要な処理を実装します。

この方法を使えば、ファイルがいつ変更されたかを簡単に知ることができ、さまざまな用途に応用できます。

filemtime関数とは？

filemtime関数は、PHPにおいて指定したファイルの最終更新時刻を取得するための関数です。この関数は、ファイルが最後に変更された時刻をUnixタイムスタンプ形式（1970年1月1日からの経過秒数）で返します。

たとえば、ファイルが最後に更新された時間を確認したい場合や、キャッシュシステムの更新管理に利用されることが多く、ファイルの状態を時間ベースで管理する際に便利です。

filemtime(ファイルパス)

この関数にファイルのパスを渡すと、そのファイルの最終更新時刻がUnixタイムスタンプで返されます。ファイルが存在しない場合や、アクセス権がない場合はfalseを返します。

• Unixタイムスタンプ形式で時間を返すため、タイムスタンプを他の形式（例: 日付や時間）に変換するにはdate関数を使う必要があります。
• filemtime関数は読み取り専用であり、ファイルを変更することなく、更新情報を取得するため安全に利用できます。
• ファイルが存在しない場合はfalseを返すため、エラーハンドリングを行うことが推奨されます。

この関数を活用することで、ファイルの変更日時をもとに効率的な処理を行うことが可能です。

filemtime関数の使い方

filemtime関数を使えば、指定されたファイルの最終更新時刻を簡単に取得することができます。使い方は非常にシンプルで、ファイルパスを引数として渡すだけで、そのファイルの最終更新時刻をUnixタイムスタンプで返します。

$更新時刻 = filemtime('ファイルパス');

ここで、filemtime('ファイルパス')はファイルのパスを指定して、そのファイルの最終更新時刻を返します。返される値はUnixタイムスタンプ形式です。ファイルが存在しない場合や、アクセス権がない場合はfalseが返されます。

サンプルプログラムの解説

以下のサンプルプログラムでは、filemtime関数を使ってファイルの最終更新時刻を取得し、それを人間が読みやすい形式で表示する方法を説明しています。

$ファイルパス = 'example.txt';
$更新時刻 = filemtime($ファイルパス);

if ($更新時刻 !== false) {
    echo 'ファイルの最終更新時刻: ' . date("Y-m-d H:i:s", $更新時刻);
} else {
    echo 'ファイルが存在しません。';
}

プログラムの各部分の解説

1. $ファイルパス = ‘example.txt’;
   • ファイルのパスを指定する変数です。ここで指定されたファイルの最終更新時刻が取得されます。
   • 例として'example.txt'が使用されていますが、任意のファイルパスを指定できます。
2. $更新時刻 = filemtime($ファイルパス);
   • filemtime関数を使用して、指定したファイルの最終更新時刻（Unixタイムスタンプ）を取得しています。
   • もしファイルが存在しない場合やアクセス権がない場合、falseが返されます。
3. if ($更新時刻 !== false) { … }
   • ここでは、filemtime関数が返す値がfalseかどうかを確認しています。falseでない場合、つまりファイルが存在する場合に次の処理に進みます。
4. date(“Y-m-d H:i“, $更新時刻);
   • 取得したUnixタイムスタンプを、date関数を使って「年-月-日 時:分:秒」の形式に変換しています。
   • これにより、Unixタイムスタンプが人間にとって読みやすい形式で表示されます。
5. echo ‘ファイルの最終更新時刻: ‘ . date(“Y-m-d H:i“, $更新時刻);
   • 最終更新時刻をフォーマットした結果を画面に出力しています。
6. else { echo ‘ファイルが存在しません。’; }
   • ファイルが存在しない場合や、filemtime関数がfalseを返した場合に、このメッセージが表示されます。
   • このように、エラーハンドリングを行うことで、ユーザーにわかりやすいエラーメッセージを表示しています。

まとめ

ファイルの最終更新時刻を確認することは、ファイル管理やキャッシュ制御において非常に役立ちます。特に、複数のファイルを扱う際には、変更のあったファイルだけを効率的に処理できるため、システムのパフォーマンスを向上させることが可能です。