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 clés, 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éro | Nom (depuis PHP 4.0.6) | Description |
|---|
| 0 | dev | volume |
| 1 | ino | inode |
| 2 | mode | droits d'accès à l'inode |
| 3 | nlink | nombre de liens |
| 4 | uid | userid du propriétaire |
| 5 | gid | groupid du propriétaire |
| 6 | rdev | type de volume, si le volume est * |
| 7 | size | taille en octets |
| 8 | atime | date de dernier accès (Unix timestamp) |
| 9 | mtime | date de dernière modification (Unix timestamp) |
| 10 | ctime | date de dernier changement d'inode (Unix timestamp) |
| 11 | blksize | taille de bloc |
| 12 | blocks | nombre 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() pour plus
de détails.
Astuce : Depuis
PHP 5.0.0 cette fonction peut aussi être utilisée avec
quelques protocoles url. Lisez Annexe M
pour une liste des protocoles supportant la famille de fonctionnalités de
stat().
Voir aussi
lstat(),
fstat(),
filemtime() et
filegroup().
