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

touch · 设定文件的访问和修改时间

· 52CE 我爱测

尝试将由 filename 给出的文件的访问和修改时间设定为给出的 mtime。 注意访问时间总是会被修改的,不论有几个参数。

touch

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

touch — 设定文件的访问和修改时间

说明

function touch(string $filename, ?int $mtime = null, ?int $atime = null): bool

尝试将由 filename 给出的文件的访问和修改时间设定为给出的 mtime。 注意访问时间总是会被修改的,不论有几个参数。

如果文件不存在,则会被创建。

参数

filename

要设定的文件名。

mtime

要设定的时间。如果参数 mtime 为 null,则会使用当前系统的 time()。

atime

如果这个参数不是 null,则给定文件的访问时间会被设为 atime。 否则会设置为 mtime。 如果两个参数都是 null,则使用当前系统时间。

更新日志

版本 说明
8.0.0 mtime 和 atime 现在可以为空。

返回值

成功时返回 true, 或者在失败时返回 false。

示例

示例 #1 touch() 例子

<?php
if (touch($filename)) {
    echo $filename . ' modification time has been changed to present time';
} else {
    echo 'Sorry, could not change modification time of ' . $filename;
}
?>

示例 #2 使用 mtime 参数的 touch()

<?php
// This is the touch time, we'll set it to one hour in the past.
$time = time() - 3600;

// Touch the file
if (!touch('some_file.txt', $time)) {
    echo 'Whoops, something went wrong...';
} else {
    echo 'Touched file with success';
}
?>

注释

注意:

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

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

资料来源与适用范围

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

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

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