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 "文件不存在或無權限";
}
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'); // 返回新時間戳
<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>
$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);
}
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;
}
// 記錄上傳時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 | 內容修改時間 | 版本號、緩存失效、同步觸發 |
filectime | inode變更時間(權限、擁有者、鏈接數變更) | 安全審計、備份判斷 |
fileatime | 最後訪問時間 | 熱度分析(許多系統關閉atime更新以提升性能) |
file_put_contents、copy、rename)緊跟clearstatcache(true, $path)。filemtime考慮緩存到Redis(鍵fmtime:{path},TTL 1秒)。filectime為創建時間,跨平台代碼勿依賴ctime語義。掌握filemtime緩存特性,能構建可靠的靜態資源版本控制、熱重載、緩存失效機制。