大网数据广告活动
PHP 语言与运行手册

filectime · 取得文件的 inode 修改时间

· 52CE 我爱测

返回文件上次 inode 被修改的时间, 或者在失败时返回 false。 时间以 Unix 时间戳的方式返回。

filectime

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

filectime — 取得文件的 inode 修改时间

说明

function filectime(string $filename): int|false

取得文件的 inode 修改时间。

参数

filename

文件的路径。

返回值

返回文件上次 inode 被修改的时间, 或者在失败时返回 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 文件系统中,当一个文件的 inode 数据被改变时则该文件被认为是修改了。也就是说,当文件的权限,所有者,所有组或其它 inode 中的元数据被更新时。参见 filemtime()(这才是你想用于在 Web 页面中建立“最后更新时间”脚注的函数)和 fileatime()。

注意:

注意某些 Unix 说明文本中把 ctime 说成是该文件建立的时间,这是错的。在大多数 Unix 文件系统中没有 Unix 文件的建立时间。

注意:

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

注意:

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

小技巧

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

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。