Manuel PHP
Précédent |  | Suivant

# 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é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() 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().

Précédent | Sommaire | Suivant
set_file_buffer | Niveau supérieur | symlink