touch

(PHP 4, PHP 5, PHP 7)

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

说明

touch ( string $filename [, int $time = time() [, int $atime ]] ) : bool

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

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

参数

filename

要设定的文件名。

time

要设定的时间。如果没有提供参数 time 则会使用当前系统的时间。

atime

如果给出了这个参数,则给定文件的访问时间会被设为 atime,否则会设置 为time。如果没有给出这两个参数,则使用当前系统时间。

返回值

成功时返回 TRUE, 或者在失败时返回 FALSE

更新日志

版本 说明
5.3.0 能够修改 Windows 下目录的最后修改时间。

范例

Example #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;
}
?>

Example #2 使用 time 参数的 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';
}
?>

注释

Note:

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

Warning

在 PHP 5.3.0 之前无法修改 Windows 下目录的最后修改时间。