Руководство по PHP
Пред. |  | След.

# 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) | Описание
--- | --- | ---
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(), смотрите в Прил. M.

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

Пред. | Начало | След.
set_file_buffer | Уровень выше | symlink