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 utiliza la información de status
de los enlaces simbólicos.
En caso de fallos, stat() devuelve
FALSE. También arrojará una advertencia.
Devuelve una matriz con las estadísticas del archivo, con
los siguientes elementos. Esta matriz comienza en
cero. 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; esta alternativa está disponible a
partir de PHP 4.0.6:
Tabla 1. 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 (como Windows)
devuelven -1.
Nota: Los resultados de esta
función son guardados. Consultar
clearstatcache() para más
detalles.
Sugerencia: A partir de PHP 5.0.0,
esta funcion tambien puede usarse con algunas URL
como nombre de fichero. Consultar Apéndice L, para
obtener una lista con soporte para la funcionalidad
stat().
Vea también lstat(),
fstat(),
filemtime(), y
filegroup().
