函数名称:touch()
适用版本:PHP 4, PHP 5, PHP 7
函数描述: touch() 函数用于设置指定文件的访问和修改时间。如果文件不存在,则会创建一个新文件。
语法: bool touch ( string $filename [, int $time = time() [, int $atime ]] )
参数:
- filename: 必需。指定要设置访问和修改时间的文件名。
- time: 可选。指定要设置的修改时间。默认值为当前时间。
- atime: 可选。指定要设置的访问时间。如果没有提供该参数,则使用 time 参数的值。
返回值: 如果成功设置了文件的访问和修改时间,则返回 true。如果发生错误,则返回 false。
示例:
- 设置文件的访问和修改时间为当前时间:
$filename = 'path/to/file.txt';
touch($filename);
- 设置文件的访问和修改时间为指定时间:
$filename = 'path/to/file.txt';
$time = strtotime('2022-01-01 00:00:00');
touch($filename, $time);
- 设置文件的访问时间为指定时间,修改时间为当前时间:
$filename = 'path/to/file.txt';
$time = strtotime('2022-01-01 00:00:00');
touch($filename, time(), $time);
注意事项:
- 如果文件不存在,touch() 函数会尝试创建一个新的空文件。
- 如果文件不可写或者目录不可写,touch() 函数将会返回 false。
- 如果提供的文件名包含相对路径,那么文件将相对于当前工作目录进行操作。
- 如果提供的文件名包含绝对路径,那么文件将相对于根目录进行操作。
- 如果文件名包含符号链接,touch() 函数将会对符号链接指向的实际文件进行操作。