fileatime

(PHP 4, PHP 5, PHP 7, PHP 8)

fileatime — Gets last access time of file

Опис

fileatime(string $filename): int|false

Gets the last access time of the given file.

Параметри

filename: Path to the file.

Значення, що повертаються

Returns the time the file was last accessed, або false в разі помилки. The time is returned as a Unix timestamp.

Помилки/виключення

Під час збоїв буде видаватись E_WARNING.

Приклади

Приклад #1 fileatime() example

<?php

// outputs e.g.  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));
}

?>

Примітки

Зауваження:
The atime of a file is supposed to change whenever the data blocks of a file are being read. This can be costly performance-wise when an application regularly accesses a very large number of files or directories.

Some Unix filesystems can be mounted with atime updates disabled to increase the performance of such applications; USENET news spools are a common example. On such filesystems this function will be useless.

Зауваження:
Варто зауважити, що точність часових міток у різних файлових систем може бути різна.

Зауваження: Рузультати цієї функції кешуються. Докладніше: clearstatcache().

Підказка

Починаючи з PHP 5.0.0, ця функція також може бути використана з деякими URL-обгортками. На сторінці Підтримувані протоколи та обгортки вказано, які обгортки підтримують сімейство функцій stat().

Прогляньте також

filemtime() - Gets file modification time
fileinode() - Gets file inode
date() - Format a Unix timestamp