當前位置: 首頁> 最新文章列表> PHP filemtime() 函數詳解:獲取文件最後修改時間的方法與示例

PHP filemtime() 函數詳解:獲取文件最後修改時間的方法與示例

M66 2025-07-09

filemtime()函數概述

在PHP開發中,獲取文件的最後修改時間是一個常見的需求。 filemtime() 函數正是用於完成這一任務的工具。通過它可以獲取指定文件的Unix 時間戳,便於進行文件監控、緩存處理等操作。

函數語法

<span class="fun">int filemtime ( string $filename )</span>

該函數接收一個參數:文件的路徑,可以是相對路徑或絕對路徑。返回值是文件的最後修改時間戳,如果文件不存在或無法讀取,則返回false

參數說明

  • $filename :要獲取最後修改時間的文件名或完整路徑。

返回值

  • 成功時,返回文件的最後修改時間戳(一個整數)。
  • 失敗時,返回false ,例如文件不存在或沒有權限訪問。

代碼示例

<?php
$file = './test.txt'; // 設置要檢測的文件路徑

if (file_exists($file)) {
    $lastModifiedTime = filemtime($file); // 獲取文件的最後修改時間
    echo "文件最後修改時間:" . date("Y-m-d H:i:s", $lastModifiedTime);
} else {
    echo "文件不存在!";
}
?>

代碼解析

在上述示例中,我們首先設定了一個文件路徑./test.txt 。為了避免在文件不存在時調用filemtime() 報錯,先使用file_exists()檢查文件是否存在。

如果文件存在,filemtime() 會返回文件最後一次修改的Unix 時間戳。使用date()函數將其格式化為可讀性更強的時間格式,最終輸出結果。

使用建議與註意事項

  • 在調用filemtime() 之前務必使用file_exists() 檢查文件是否存在,以確保代碼的健壯性。
  • filemtime() 返回的是時間戳,需要藉助date() 函數轉換成標準時間格式。
  • 如果涉及跨平台文件操作,確保路徑分隔符的使用與系統兼容。

總結

filemtime() 是PHP 中用於文件操作的實用函數之一,特別適用於需要判斷文件更新時間、生成緩存機制等場景。通過結合file_exists() 和date(),可以更安全、直觀地獲取並展示文件的最後修改時間。

掌握filemtime() 的用法,能為日常PHP 文件管理和處理提供極大的便利。