touch() 函数的第二个参数与第三个参数的使用示例

gitbox 2025-06-06

在 PHP 中，touch() 函数常用于修改文件的访问时间（atime）和修改时间（mtime），或者在文件不存在时创建一个空文件。这个函数的完整语法如下：

bool touch(string $filename, int $mtime = time(), int $atime = $mtime)

从函数定义可以看出，touch() 有三个参数：

$filename：要操作的文件路径。
$mtime：可选，设置文件的修改时间（默认为当前时间）。
$atime：可选，设置文件的访问时间（默认与 $mtime 相同）。

参数详解

$mtime - 修改时间

这是指文件的最后修改时间，单位是 Unix 时间戳（自 1970 年 1 月 1 日起的秒数）。如果文件存在，则它的 mtime 会被更新为这个时间；如果文件不存在，则会创建新文件，并设置该时间。

$atime - 访问时间

这个参数用来设置文件的最后访问时间，也是 Unix 时间戳格式。这个时间可以与 $mtime 不同，用于更细致地控制文件的元数据。

示例说明

下面通过一个例子说明这两个参数的实际用法。

<?php
// 假设要操作的文件路径
$filename = 'example.txt';

// 设置的时间：2023-01-01 12:00:00
$mtime = strtotime('2023-01-01 12:00:00');
// 设置的访问时间：2022-12-31 23:59:59
$atime = strtotime('2022-12-31 23:59:59');

// 使用 touch() 设置文件的 mtime 和 atime
if (touch($filename, $mtime, $atime)) {
    echo "文件时间修改成功";
} else {
    echo "文件时间修改失败";
}
?>

这段代码中，如果 example.txt 不存在，它会被创建；随后其修改时间会被设置为 2023 年 1 月 1 日中午 12 点，访问时间设置为 2022 年 12 月 31 日晚上 11 点 59 分 59 秒。

在实际应用中用来做什么？

伪造文件时间：在测试或特定业务逻辑中，可能需要将文件的时间戳设置为某个历史时间。
配合缓存机制：某些缓存系统根据文件的修改时间来判断是否更新内容，手动设置时间戳可以控制缓存行为。
模拟用户访问日志：在构建日志模拟系统时，可通过设置 atime 模拟用户的文件访问行为。

小贴士

如果服务器启用了某些安全设置，比如基于文件时间的访问控制（例如备份脚本只处理最近修改的文件），修改时间可能影响程序的行为。因此在使用 touch() 时需要格外小心，避免引起副作用。

示例场景：上传文件后设置固定时间戳

假设用户上传了一张图片，我们希望把它的时间戳固定为 2024 年 12 月 31 日，可以这样做：

<?php
$uploadPath = '/var/www/gitbox.net/uploads/user_photo.jpg';
$mtime = strtotime('2024-12-31 00:00:00');

if (touch($uploadPath, $mtime)) {
    echo "时间戳设置成功";
}
?>

以上代码会将 gitbox.net 网站某用户上传图片的时间固定，便于后续文件管理或系统对接。

总结

touch() 的第二个和第三个参数为开发者提供了对文件时间的精细控制能力。无论是在日志模拟、缓存控制还是文件元信息伪造方面，合理使用这两个参数都能带来更大的灵活性。掌握这项技能，可以让你在处理文件系统相关逻辑时更加游刃有余。

touch