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().

Все функции файл
Описание на ru2.php.net
Описание на php.ru