萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP filemtime()函數詳解:獲取文件修改時間、緩存機制、清除緩存與應用場景

filemtime()返回文件內容最後修改時間(Unix時間戳),是靜態資源版本控制、緩存失效、文件監控的核心函數。本文詳解參數、返回值、緩存陷阱、clearstatcache()用法及實戰場景。

函數原型

filemtime(string $filename): int|false
// 成功返回Unix時間戳,失敗返回false並觸發E_WARNING

基本用法

<?php
$file = 'test.txt';
$mtime = filemtime($file);
if ($mtime !== false) {
    echo "最後修改: " . date('Y-m-d H:i:s', $mtime);
} else {
    echo "文件不存在或無權限";
}

關鍵陷阱:stat緩存

PHP為性能將stat系統調用結果緩存(包括filemtime、filesize、is_file等)。**同一腳本執行期間,文件被外部修改後再次調用返回舊值**。

$mtime1 = filemtime('data.txt');
sleep(1);
file_put_contents('data.txt', 'new content'); // 外部修改
$mtime2 = filemtime('data.txt'); // 可能仍返回舊時間戳!
clearstatcache(true, 'data.txt'); // PHP 5.3+ 支持針對特定路徑清除
$mtime3 = filemtime('data.txt'); // 返回新時間戳

實戰應用場景

1. 靜態資源版本號(防緩存)

<link rel="stylesheet" href="/assets/app.css?v=<?= filemtime(__DIR__ . '/../public/assets/app.css') ?>">
<script src="/assets/app.js?v=<?= filemtime(__DIR__ . '/../public/assets/app.js') ?>"></script>

2. 簡單文件監控/熱重載

$lastMtime = 0;
while (true) {
    $current = filemtime('config.json');
    if ($current > $lastMtime) {
        $lastMtime = $current;
        $config = json_decode(file_get_contents('config.json'), true);
        echo "配置已重載\n";
    }
    sleep(1);
}

3. 緩存失效判斷

function get_cached_data(string $cacheFile, int $ttl = 300): mixed {
    if (file_exists($cacheFile) && (time() - filemtime($cacheFile) < $ttl)) {
        return unserialize(file_get_contents($cacheFile));
    }
    // 重新生成...
    $data = generate_data();
    file_put_contents($cacheFile, serialize($data));
    return $data;
}

4. 上傳文件完整性校驗

// 記錄上傳時mtime,後續驗證未被篡改
$record = ['path' => $path, 'mtime' => filemtime($path), 'size' => filesize($path), 'hash' => hash_file('sha256', $path)];
// 後續校驗
if (filemtime($record['path']) !== $record['mtime']) {
    throw new RuntimeException('文件已被修改');
}

相關函數對比

函數含義典型用途
filemtime內容修改時間版本號、緩存失效、同步觸發
filectimeinode變更時間(權限、擁有者、鏈接數變更)安全審計、備份判斷
fileatime最後訪問時間熱度分析(許多系統關閉atime更新以提升性能)

最佳實踐

  • 文件操作後(file_put_contents、copy、rename)緊跟clearstatcache(true, $path)。
  • 高併發讀取filemtime考慮緩存到Redis(鍵fmtime:{path},TTL 1秒)。
  • Windows下filectime為創建時間,跨平台代碼勿依賴ctime語義。

掌握filemtime緩存特性,能構建可靠的靜態資源版本控制、熱重載、緩存失效機制。

copyright © 萬盛學電腦網 all rights reserved