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

getlastmod関数は、現在実行されているPHPスクリプトファイルの最終更新時刻を取得する関数です。この関数は、ウェブサーバー上で動作するPHPスクリプトがいつ最後に更新されたかを確認したい場合に非常に役立ちます。例えば、ウェブサイトの訪問者に対して、ページのフッターに「このページはYYYY年MM月DD日に更新されました」といった形で最終更新日を表示する際や、スクリプトのキャッシュがまだ有効であるかどうかの判断基準として利用する場面が考えられます。

この関数は引数を必要としません。実行されると、現在のスクリプトファイルが最後に変更された日時をUNIXタイムスタンプ形式で返します。UNIXタイムスタンプとは、1970年1月1日0時0分0秒（UTC）からの経過秒数を表す数値のことで、プログラミングにおいて日付や時刻を内部的に扱う際によく用いられる形式です。取得したタイムスタンプは、PHPのdate()関数などを用いることで、「2023-10-27 10:30:00」のような人間が読みやすい日付と時刻の文字列に簡単に変換できます。もし、何らかのシステム的な問題により最終更新時刻の取得に失敗した場合、この関数はブール値のfalseを返します。そのため、関数の戻り値がfalseでないことを確認することで、処理が成功したかどうかを判断し、適切にエラーハンドリングを行うことが重要です。getlastmod関数は、ウェブコンテンツの鮮度をユーザーに伝えたり、サーバーサイドでのファイル管理や更新状況のトラッキングを行う上で、シンプルながらも非常に便利な機能を提供します。

<?php
$lastModificationTime = getlastmod();
?>

引数なし

引数はありません

int|false

指定されたファイルが最後に変更されたUnixタイムスタンプ（1970年1月1日午前0時0分0秒からの経過秒数）を返します。ファイルが存在しない、または読み込み権限がない場合はfalseを返します。