# fstat

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

fstat — Lit les informations sur un fichier à partir d'un pointeur de fichier

### Description

fstat(resource `$stream`): array|false

Rassemble les informations sur le fichier dont on connaît le pointeur `stream`. fstat() est similaire à la fonction stat(), hormis le fait qu'elle utilise un pointeur de fichier, au lieu d'un nom de fichier.

### Liste de paramètres

`stream`

  Un pointeur de système de fichiers de type resource qui est habituellement créé en utilisant la fonction fopen().

### Valeurs de retour

Retourne un tableau contenant les statistiques pour le fichier ; le format de ce tableau est décrit en détail sur la page de documentation de la fonction stat(). Retourne `false` en cas d'échec.

### Exemples

Exemple #1 Exemple avec fstat()

`<?php
// ouvre un fichier
$fp = fopen("/etc/passwd", "r");
// lit des informations
$fstat = fstat($fp);
// ferme le fichier
fclose($fp);
// affiche le résultat
print_r(array_slice($fstat, 13));
?>`

Résultat de l'exemple ci-dessus est similaire à :

    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
    )

### Notes

> Note: Cette fonction ne fonctionne pas avec les fichiers distants, car le fichier examiné doit être accessible sur le système de fichiers du serveur.