fileatime
(PHP 4, PHP 5)
fileatime — Возвращает время последнего доступа к файлу
Описание
int fileatime
( string $filename
)
Возвращает время последнего доступа к файлу.
Список параметров
-
filename
-
Путь к файлу.
Возвращаемые значения
Возвращает время, когда в последний раз был осуществлен доступ
к указанному файлу, или FALSE в случае возникновения ошибки.
Время возвращается в виде временной метки Unix.
Примеры
Пример #1 Пример использования функции fileatime()
<?php
// Пример вывода: В последний раз обращение к файлу somefile.txt было произведено: December 29 2002 22:16:23.
$filename = 'somefile.txt';
if (file_exists($filename)) {
echo "В последний раз обращение к файлу $filename было произведено: " . date("F d Y H:i:s.", fileatime($filename));
}
?>
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING.
Примечания
Замечание:
Предполагается, что время последнего доступа файла
изменяется во время чтения блоков файла. Это может потребовать
значительного количества системных ресурсов, особенно когда
приложение обращается к большому числу файлов или каталогов.
С целью увеличения производительности некоторые файловые системы
на платформах Unix могут быть примонтированы с отключенной
возможностью обновления времени последнего доступа к файлам,
примером этого могут служить каталоги для хранения сообщений
USENET. В подобных случаях использование данной функции бессмысленно.
Замечание:
Учтите, что обработка времени может
отличаться в различных файловых системах.
Замечание: Результаты этой функции
кэшируются. Более подробную информацию смотрите в разделе
clearstatcache().
Смотрите также
- filemtime() - Возвращает время последнего изменения файла
- fileinode() - Возвращает индексный дескриптор файла
- date() - Форматирует вывод системной даты/времени