fileatime
(PHP 4, PHP 5, PHP 7)
fileatime — Возвращает время последнего доступа к файлу
Описание
$filename
) : int|falseВозвращает время последнего доступа к файлу.
Список параметров
-
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().
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обертками url. Список оберток, поддерживаемых семейством функций stat(), смотрите в разделе Поддерживаемые протоколы и обертки.
Смотрите также
- filemtime() - Возвращает время последнего изменения файла
- fileinode() - Возвращает индексный дескриптор файла
- date() - Форматирует вывод системной даты/времени