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