fileatime
(PHP 4, PHP 5, PHP 7, PHP 8)
fileatime — 取得檔案的上次訪問時間
說明
fileatime(string
$filename): int取得檔案的上次訪問時間。
參數
-
filename -
檔案的路徑。
返回值
返回檔案上次被訪問的時間， 或者在失敗時返回 false。時間以 Unix 時間戳的方式返回。
範例
示例 #1 fileatime() 例子
<?php
// 輸出類似：somefile.txt was last accessed: December 29 2002 22:16:23.
$filename = 'somefile.txt';
if (file_exists($filename)) {
echo "$filename was last accessed: " . date("F d Y H:i:s.", fileatime($filename));
}
?>
錯誤／異常
失敗時拋出E_WARNING警告。
註釋
注意:
注意：一個檔案的 atime 應該在不論何時讀取了此檔案中的數據塊時被更改。當一個應用程式定期訪問大量檔案或目錄時很影響效能。
有些 Unix 檔案系統可以在載入時關閉 atime 的更新以提高這類程式的效能。USENET 新聞組假離線是一個常見的例子。在這種檔案系統下本函式沒有用處。
注意:
注意：不同檔案系統對時間的判斷方法可能是不相同的。
注意: 此函式的結果會被快取。參見 clearstatcache() 以獲得更多細節。
小技巧
自 PHP 5.0.0 起, 此函式也用於某些 URL 包裝器。請參見 支援的協議和封裝協議以獲得支援 stat() 系列函式功能的包裝器列表。