touch
(PHP 4, PHP 5)
touch — 设定文件的访问和修改时间
说明
bool touch
( string $filename
[, int $time = time()
[, int $atime
]] )
尝试将由 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 下目录的最后修改时间。