Sistema de archivos
PHP Manual

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


Sistema de archivos
PHP Manual