stat

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

stat — Entrega información sobre un archivo

Descripción

array stat ( string $nombre_archivo )

Reúne las estadísticas del archivo con el nombre nombre_archivo . Si nombre_archivo es un enlace simbólico, las estadísticas son del archivo mismo, no del enlace.

lstat() es una función idéntica a stat(), con la excepción de que esta última utiliza la información de status de los enlaces simbólicos.

Lista de parámetros

nombre_archivo: Ruta al archivo.

Valores retornados

**Formato de resultados de **stat()** y fstat()**
Numérico	Asociativo (desde PHP 4.0.6)	Descripción
0	dev	número de dispositivo
1	ino	número de inode
2	mode	modo de protección inode
3	nlink	número de enlaces
4	uid	id de usuario del dueño
5	gid	id de grupo del dueño
6	rdev	tipo de dispositivo, si hay dispositivo inode *
7	size	tamaño en bytes
8	atime	hora del último acceso (marca de tiempo Unix)
9	mtime	hora de la última modificación (marca de tiempo Unix)
10	ctime	hora del último cambio del inode (marca de tiempo Unix)
11	blksize	tamaño de bloque de E/S del sistema de archivos *
12	blocks	número de bloques reservados *

* Válido únicamente en sistemas que soportan el tipo st_blksize - los demás sistemas (p.ej. Windows) devuelven -1.

En caso de error, stat() devuelve FALSE.

Errors/Exceptions

En caso de fallo, un error de nivel E_WARNING es emitido.

Registro de cambios

Versión	Descripción
4.0.6	Además de devolver estos atributos en una matriz numérica, éstos pueden ser accesados con índices asociativos, como se nota al lado de cada parámetro

Notes

Note: Los resultados de esta función son guardados. Consultar clearstatcache() para más detalles.

Tip

A partir de PHP 5.0.0, esta funcion tambien puede usarse con algunas URL como nombre de fichero. Consultar Lista de Protocolos/Envolturas Soportadas, para obtener una lista con soporte para la funcionalidad stat().

Ver también