stat

(PHP 4, PHP 5, PECL maxdb:7.5.00.24-7.6.00.38)

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

Описание

array stat ( string $filename )

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

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

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

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

Числовой Ассоциативный (начиная с PHP 4.0.6) Описание

0 dev номер устройства

1 ino номер inode

2 mode режим защиты inode

3 nlink количество ссылок

4 uid userid владельца

5 gid groupid владельца

6 rdev тип устройства, если устройство inode *

7 size размер в байтах

8 atime время последнего доступа (Unix timestamp)

9 mtime время последней модификации (Unix timestamp)

10 ctime время последнего изменения inode (Unix timestamp)

11 blksize размер блока ввода-вывода файловой системы *

12 blocks количество используемых блоков

* - доступен только на системах, поддерживающих тип st_blksize -- другие системы (например Windows) вернут -1.

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

Подсказка

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

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