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() 以獲得更多細節(jié)。

小技巧

自 PHP 5.0.0 起, 此函數也用于某些 URL 包裝器。請參見 支持的協議和封裝協議以獲得支持 stat() 系列函數功能的包裝器列表。

參見