stat
(PHP 4, PHP 5, PECL maxdb:7.5.00.24-7.6.00.38)
stat — Получает информацию о файле
Описание
Собирает статистическую информацию о файле filename . Если filename является символической ссылкой, информация собирается о самом файле, а не ссылке. Функция lstat() индентична функции stat() за исключением того, что в данном случае она вернёт информацию о самой символической ссылке.
В случае ошибки, stat() вернёт FALSE. Также она выдаст предупреждение.
Возвращает массив статистической информации о файле. Массив включает следующие элементы. Индексация начинается с нуля. Также доступ к любому аттрибуту можно получить по ассоциативному ключу, который указан напротив каждого параметра; эта возможность появилась начиная с версии PHP 4.0.6:
| Числовой | Ассоциативный (начиная с 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 | количество используемых блоков |
Note: Результаты этой функции кэшируются. Более подробную информацию смотрите в разделе clearstatcache().
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми упаковщиками url. Список упаковщиков, поддерживаемых семейством функций stat(), смотрите в List of Supported Protocols/Wrappers.
См. также описание функций lstat(), fstat(), filemtime() и filegroup().