PHP 文件系统 filemtime() 函数

---

---

PHP 文件系统filemtime()函数用于返回文件内容上次修改的时间。基本上，它在成功时返回最后修改时间的 Unix 时间戳，失败时返回 false。

此函数可以返回写入文件数据块的时间，也就是文件内容发生更改的时间。

语法

以下是 PHP 文件系统filemtime()函数的语法：

int filemtime ( string $filename )

参数

以下是此函数的参数：

返回值

该函数在成功时返回文件的最后修改时间（Unix 时间戳），如果文件不存在或发生错误，则返回 FALSE。

PHP 版本

filemtime()函数最初作为核心 PHP 4 的一部分引入，并能很好地与 PHP 5、PHP 7、PHP 8 一起使用。

示例

在下面的示例代码中，我们将使用 PHP 文件系统filemtime()函数获取函数中提到的文件的最后修改时间和日期。

由于此函数将最近的修改时间检索为 Unix 时间戳，因此我们将将其转换为易于阅读的日期和时间字符串。

<?php
   echo filemtime("/PhpProject/sample.txt"); 
   echo "\n";
   echo "Last modified: ".date("F d Y H:i:s.",filemtime("/PhpProject/sample.txt"));
?>

输出

这将导致以下结果：

1590392449
Last modified: May 25 2020 09:40:49.

示例

此示例向我们展示了如何使用filemtime()函数通过将其修改时间与当前时间进行比较来检查文件的“年龄”。

<?php
   // Get the modification time of the file (replace the file path with your file)
   $modTime = filemtime("/Applications/XAMPP/xamppfiles/htdocs/mac/myfile.txt");

   // Get the current time
   $currentTime = time();

   // Get the age of the file in seconds
   $fileAge = $currentTime - $modTime;

   // change seconds to days
   $fileAgeInDays = floor($fileAge / (60 * 60 * 24));

   // echo the age of the file
   echo "File age: $fileAgeInDays days";
?> 

输出

这将产生以下结果：

File age: 3 days

示例

此示例向我们展示了如何使用filemtime()函数通过将修改时间戳附加到文件名来获取文件版本。

借助 rename() 函数，旧文件将重命名为包含修改时间戳的新文件名。

<?php
   // Define the file path 
   $filename = "/Applications/XAMPP/xamppfiles/htdocs/mac/myfile.txt";

   //Get the modification time
   $modTime = filemtime($filename);

   // Append modification timestamp to filename
   $newFilename = basename($filename, ".txt") . "_v$modTime.txt";

   // Rename the file
   rename($filename, $newFilename);

   echo "File renamed to: $newFilename";
?> 

输出

这将生成以下结果：

File renamed to: myfile_v1716886151.txt

示例

此示例展示了如何简单地比较文件的修改时间以确保没有任何更改。因此，我们将使用循环来比较初始修改时间和当前修改时间。

如果修改时间发生变化，则循环结束，并打印显示“文件已修改！”的消息。

<?php
   // Define the file path 
   $filename = "/Applications/XAMPP/xamppfiles/htdocs/mac/myfile.txt";
   
   $initialModTime = filemtime($filename);
   
   while (true) {
      // Clear the file status cache
      clearstatcache(); 
      $currentModTime = filemtime($filename);
   
      if ($currentModTime != $initialModTime) {
            echo "File has been modified!";
            break;
      }
   
      // Wait for 5 seconds before checking again
      sleep(5); 
   }
?> 

输出

这将产生以下结果：

File has been modified!

注意

因为它在失败时返回 false，所以它经常用于 if 语句或三元运算符等条件表达式中进行错误处理。

总结

filemtime()对于 PHP 开发人员处理文件操作是一个有用的工具，无论他们是用它进行版本检查、基本检查、文件年龄还是监控。