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 ressource 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.

add a note

User Contributed Notes 2 notes

down

tom at bitworks dot de ¶

7 years ago


Remember atime will not be updated by simple read access to the file unless you take care for that in the mounting parameters of your filesystem.  

Instead of atime, mtime will be delivered. But mtime only will be updated, if the contents of the file has changed.

Due to this behavior take care in your Session-System. Using session_start() will not be sufficiant to keep your sessions alive. You should write into the Session, e. g. :  

$_SESSION = time();  

That retriggers your mtime and atime, even if the mounting parameter for atime is set to "noatime" or is missing, dependent of the used file System.

down

broom at alturnanetworks dot com ¶

16 years ago


Another ftp_get_contents() approach, using a temperary stream handler. Returns file contents of remote file as string. 



<?php

function ftp_get_contents ($conn_id, $remote_filename) {

    //Create temp handler:

    $tempHandle = fopen('php://temp', 'r+');



    //Get file from FTP assuming that it exists:

    ftp_fget($conn_id, $tempHandle, $remote_filename, FTP_ASCII, 0));



    //Getting detailed stats to check filesize:

    $fstats = fstat($tempHandle);



    return fread($tempHandle, $fstats['size']);

}

?>



(It is recommended to add some error handling)

add a note