stat

(PHP 3, PHP 4 , PHP 5)

stat -- Renvoie les informations à propos d'un fichier

Description

array stat ( string filename )

stat() renvoie les informations à propos du fichier filename. Si filename est un lien symbolique, les informations proviennent du fichier lui-même, et non du lien symbolique. lstat() est identique à stat() sauf que les informations seront alors basées sur le lien symbolique.

En cas d'erreurs, stat() retourne FALSE. Elle générera aussi un avertissement.

Retourne un tableau avec des informations sur le fichier avec les éléments suivants. Ce tableau commence à zéro. En plus de retourner ces attributs dans un tableau indexé, ils peuvent être accédés par leurs clefs, comme mentionné à côté de chaque paramètre ; ceci est disponible depuis PHP 4.0.6 :

Tableau 1. Résultat de stat() et fstat()

NuméroNom (depuis PHP 4.0.6)Description
0devvolume
1inoinode
2modedroits d'accès à l'inode
3nlinknombre de liens
4uiduserid du propriétaire
5gidgroupid du propriétaire
6rdevtype de volume, si le volume est *
7sizetaille en octets
8atimedate de dernier accès (Unix timestamp)
9mtimedate de dernière modification (Unix timestamp)
10ctimedate de dernier changement d'inode (Unix timestamp)
11blksizetaille de bloc
12blocksnombre de blocs alloués
* - uniquement sur les systèmes qui supportent le type st_blksize. Les autres systèmes (i.e. Windows) retournent -1.

Note : Les résultats de cette fonction sont mis en cache. Voyez la fonction clearstatcache() plus de détails.

Astuce : Depuis PHP 5.0.0 cette fonction peut aussi être utilisée avec quelques protocoles url. Lisez Annexe L pour une liste des protocoles supportant la famille de fonctionnalités de stat().

Voir aussi lstat(), fstat(), filemtime() et filegroup().