filemtime

(PHP 4, PHP 5, PHP 7, PHP 8)

filemtimeファイルの更新時刻を取得する

説明

filemtime(string $filename): int|false

この関数は、ファイルのブロックデータが書き込まれた時間を返します。 これは、ファイルの内容が変更された際の時間です。

パラメータ

filename

ファイルへのパス。

戻り値

ファイルの最終更新時刻を返し、失敗した場合に false を返します。 時間は Unix タイムスタンプとして返されます。 この関数の結果は date() 等で使用できます。

エラー / 例外

失敗したときは E_WARNING が発生します。

例1 filemtime() の例

<?php
// 出力例 somefile.txt was last modified: December 29 2002 22:16:23.

$filename 'somefile.txt';
if (
file_exists($filename)) {
    echo 
"$filename was last modified: " date ("F d Y H:i:s."filemtime($filename));
}
?>

注意

注意:

時刻の精度は、 ファイルシステムによって異なることがあります。

注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。

ヒント

PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat() ファミリーをサポートしているかを調べるには サポートするプロトコル/ラッパー を参照してください。

参考

  • filectime() - ファイルの inode 変更時刻を取得する
  • stat() - ファイルに関する情報を取得する
  • touch() - ファイルの最終アクセス時刻および最終更新日をセットする
  • getlastmod() - 最終更新時刻を取得する

関連キーワード:  時刻, 取得, 更新, ファイル, 関数, filemtime, 最終, 注意, 失敗, 参照