stat

(PHP 3, PHP 4, PHP 5)

stat -- Получает информацию о файле

Описание

array stat ( string filename )

Собирает статистическую информацию о файле filename. Если filename является символической ссылкой, информация собирается о самом файле, а не ссылке. Функция lstat() индентична функции stat() за исключением того, что в данном случае она вернёт информацию о самой символической ссылке.

В случае ошибки, stat() вернёт FALSE. Также она выдаст предупреждение.

Возвращает массив статистической информации о файле. Массив включает следующие элементы. Индексация начинается с нуля. Также доступ к любому аттрибуту можно получить по ассоциативному ключу, который указан напротив каждого параметра; эта возможность появилась начиная с версии PHP 4.0.6:

Таблица 1. Формат результата работы функций stat() и fstat()

ЧисловойАссоциативный (начиная с PHP 4.0.6)Описание
0devномер устройства
1inoномер inode
2modeрежим защиты inode
3nlinkколичество ссылок
4uiduserid владельца
5gidgroupid владельца
6rdevтип устройства, если устройство inode *
7sizeразмер в байтах
8atimeвремя последнего доступа (Unix timestamp)
9mtimeвремя последней модификации (Unix timestamp)
10ctimeвремя последнего изменения inode (Unix timestamp)
11blksizeразмер блока ввода-вывода файловой системы *
12blocksколичество используемых блоков
* - доступен только на системах, поддерживающих тип st_blksize -- другие системы (например Windows) вернут -1.

Замечание: Результаты этой функции кэшируются. Более подробную информацию смотрите в разделе clearstatcache().

Подсказка: Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми упаковщиками url. Список упаковщиков, поддерживаемых семейством функций stat(), смотрите в Прил. M.

См. также описание функций lstat(), fstat(), filemtime() и filegroup().