ファイルの inode 変更時刻を取得する

# filectime

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

filectime — ファイルの inode 変更時刻を取得する

### 説明

function filectime(string `$filename`): int|false

ファイルの inode 変更時刻を取得します。

### パラメータ

`filename`

  ファイルへのパス。

### 戻り値

ファイルの最終更新時刻を返し、失敗した場合に `false` を返します。 時間は Unix タイムスタンプとして返されます。

### エラー / 例外

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

### 例

例1 filectime() の例

    <?php

    // 出力例 somefile.txt was last changed: December 29 2002 22:16:23.

    $filename = 'somefile.txt';
    if (file_exists($filename)) {
        echo "$filename was last changed: " . date("F d Y H:i:s.", filectime($filename));
    }

    ?>

### 注意

> 注意:

> 注意: 多くの Unix ファイルシステムでは、i-ノードが変更された際、つまり、 パーミッション、所有者、グループ、または他のメタデータが書き込まれた際に、 ファイルが変更されたとみなされます。 filemtime() (この関数は、Web ページ上に "最終更新時刻" を表示させたい場合に使用するものです) および fileatime() も参照ください。

> 注意:

> いくつかの Unix では、ファイルの ctime はファイルの作成時間として参照されます。 これは間違っています。多くの Unix ファイルシステムでは Unix ファイルの作成時間は存在しません。

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

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

ヒント

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

### 参考

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open