# filemtime

(PHP 4, PHP 5, PHP 7)

filemtime — 取得文件修改时间

### 说明

filemtime ( string `$filename` ) : int

本函数返回文件中的数据块上次被写入的时间，也就是说，文件的内容上次被修改的时间。

### 参数

`filename`

  文件的路径。

### 返回值

返回文件上次被修改的时间， 或者在失败时返回 `FALSE`。时间以 Unix 时间戳的方式返回，可用于 date()。

### 范例

Example #1 filemtime() 例子

    <?php
    // outputs e.g.  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));
    }
    ?>

### 错误／异常

失败时抛出`E_WARNING`警告。

### 注释

> Note:

> 注意：不同文件系统对时间的判断方法可能是不相同的。

> Note: 此函数的结果会被缓存。参见 clearstatcache() 以获得更多细节。

Tip

自 PHP 5.0.0 起, 此函数也用于某些 URL 包装器。请参见 支持的协议和封装协议以获得支持 stat() 系列函数功能的包装器列表。

### 参见

- filectime() - 取得文件的 inode 修改时间
- stat() - 给出文件的信息
- touch() - 设定文件的访问和修改时间
- getlastmod() - 获取页面最后修改的时间