# fstat

(PHP 4, PHP 5, PHP 7, PHP 8)

fstat — Obtiene información acerca de un archivo usando un puntero al archivo abierto

### Descripción

fstat(resource `$handle`): array

Reúne las estadísticas de un archivo abierto por el puntero al archivo referenciado por `handle`. Esta función es similar a la función stat() excepto que opera sobre un puntero a un archivo en vez de sobre un nombre de archivo.

### Parámetros

`handle`

  Resource que apunta a un fichero del sitema que normalmente es creado usando fopen().

### Valores devueltos

Devuelve un matriz con las estadísticas del archivo; el formato de la matriz está descrito en la página del manual de stat().

### Ejemplos

Ejemplo #1 Ejemplo de fstat()

`<?php
// abrir un archivo
$fp = fopen("/etc/passwd", "r");
// reunir estadísticas
$fstat = fstat($fp);
// cerrar el archivo
fclose($fp);
// imprimir sólo la parte asociativa
print_r(array_slice($fstat, 13));
?>`

El resultado del ejemplo sería algo similar a:

    Array
    (
        [dev] => 771
        [ino] => 488704
        [mode] => 33188
        [nlink] => 1
        [uid] => 0
        [gid] => 0
        [rdev] => 0
        [size] => 1114
        [atime] => 1061067181
        [mtime] => 1056136526
        [ctime] => 1056136526
        [blksize] => 4096
        [blocks] => 8
    )

### Notas

> Nota: Esta función no funcionará en ficheros remotos ya que el fichero debe ser accesible vía el sistema de ficheros del servidor para poder ser examinado.