stat

(PHP 3, PHP 4 )

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 :

  1. 0 : volume (ou encore dev)

  2. 1 : inode (ou encore ino)

  3. 2 : droits d'accès au fichier (mode de protection du inode). A convertir en octal. Voir aussi fileperms(). (ou encore mode)

  4. 3 : nombre de liens (ou encore nlink)

  5. 4 : id de l'utilisateur propriétaire (ou encore uid)

  6. 5 : id du groupe propriétaire (ou encore gid)

  7. 6 : type du volume de l'inode * (ou encore rdev )

  8. 7 : taille en octets (ou encore size)

  9. 8 : date du dernier accès (ou encore atime)

  10. 9 : date de la dernière modification (ou encore mtime)

  11. 10 : date du dernier changement (ou encore ctime)

  12. 11 : taille de bloc du système pour les entrées/sorties * (ou encore blksize)

  13. 12 : nombre de blocs alloués (ou encore blocks)

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

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

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