fstat

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

fstat — Lee las informaciones sobre un fichero a partir de un puntero de fichero

Descripción

fstat(resource $stream): array|false

Recopila las informaciones sobre el fichero del cual se conoce el puntero stream. fstat() es similar a la función stat(), excepto que utiliza un puntero de fichero, en lugar de un nombre de fichero.

Parámetros

stream: Un puntero del sistema de archivos de tipo resource que es habitualmente creado utilizando la función fopen().

Valores devueltos

Devuelve un array que contiene las estadísticas para el fichero; el formato de este array se describe en detalle en la página de documentación de la función stat(). Devuelve false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con fstat()

<?php

// abre un fichero
$fp = fopen("/etc/passwd", "r");

// lee las informaciones
$fstat = fstat($fp);

// cierra el fichero
fclose($fp);

// muestra el resultado
print_r(array_slice($fstat, 13));

?>

Resultado del ejemplo anterior es 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 funciona con los archivos remotos, ya que el archivo examinado debe ser accesible en el sistema de archivos del servidor.