stat

(PHP 3, PHP 4, PHP 5)

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 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éricoAsociativo (desde PHP 4.0.6)Descripción
0devnúmero de dispositivo
1inonúmero de inode
2modemodo de protección inode
3nlinknúmero de enlaces
4uidid de usuario del dueño
5gidid de grupo del dueño
6rdevtipo de dispositivo, si hay dispositivo inode *
7sizetamaño en bytes
8atimehora del último acceso (marca de tiempo Unix)
9mtimehora de la última modificación (marca de tiempo Unix)
10ctimehora del último cambio del inode (marca de tiempo Unix)
11blksizetamaño de bloque de E/S del sistema de archivos *
12blocksnú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 M, para obtener una lista con soporte para la funcionalidad stat().

Vea también lstat(), fstat(), filemtime(), y filegroup().

Hosting by: hurra.com
Generated: 2007-01-26 18:00:50