array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.stat.php', 1 => 'stat', 2 => 'Renvoie les informations à propos d\'un fichier', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Fonctions sur les systèmes de fichiers', ), 'prev' => array ( 0 => 'function.set-file-buffer.php', 1 => 'set_file_buffer', ), 'next' => array ( 0 => 'function.symlink.php', 1 => 'symlink', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/filesystem/functions/stat.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

stat

(PHP 4, PHP 5, PHP 7, PHP 8)

stat — Renvoie les informations à propos d'un fichier

Description

stat(string $filename): array|false

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. Avant PHP 7.4.0, sous Windows NTS compile les valeurs statiques size, atime, mtime et ctime depuis les liens symboliques, dans ce cas.

lstat() est identique à stat() sauf que les informations seront alors basées sur le lien symbolique.

Liste de paramètres

filename

Le chemin vers le fichier.

Valeurs de retour

Format du résultat de stat() et fstat()
Numéro Nom Description
0 dev volume (***)
1 ino Numéro d'inode (****)
2 mode droit 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 du volume, si le volume est une inode
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 de 512 octets alloués (**)

* - Sous Windows, ceci sera toujours 0.

** - uniquement sur les systèmes qui supportent le type st_blksize. Les autres systèmes (p. ex. Windows) retournent -1.

*** - Sous Windows, à partir de PHP 7.4.0, ce sera le numéro de série du volume qui contient le fichier, qui sera un entier 64-bit non signé qui peut déborder. Auparavant, c'était la représentation numérique de la lettre du volume (c.-à-d. 2 pour C:) pour la fonction stat(), et 0 pour la fonction lstat().

**** - Sous Windows, à partir de PHP 7.4.0, c'est l'identifiant associé avec le fichier, qui sera un entier 64-bit non signé qui peut déborder. Auparavant, c'était toujours 0.

***** Sous Windows, le bit de la permission d'écriture est défini en fonction de l'attribut lecture seule du fichier, et la même valeur est rapportée pour tous les utilisateurs, groupe, et propriétaire. L'ACL n'est pas prise en compte, contrairement à is_writable().

La valeur de mode contient des informations lues par plusieurs fonctions. Écrite en octal, en commençant par la droite, les trois premiers chiffres sont retournés par chmod(). Le chiffre suivant est ignoré par PHP. Les deux chiffres suivants indiquent le type de fichier :
Les types de fichiers mode
mode en octal Signification
0140000 socket
0120000 lien symbolique
0100000 fichier régulier
0060000 périphérique bloc
0040000 dossier
0020000 périphérique de caractère
0010000 FIFO (un tube nommé)
Ainsi, par exemple, un fichier régulier pourrait être 0100644 et un dossier pourrait être 0040755.

En cas d'erreur, stat() retourne false.

Note: Comme le type entier de PHP est signé et que de nombreuses plates-formes utilisent des entiers de 32 bits, certaines fonctions relatives au système de fichiers peuvent retourner des résultats étranges pour les fichiers de taille supérieure à 2 Go.

Erreurs / Exceptions

Si une erreur survient, une alerte de type E_WARNING est émise.

Historique

Version Description
7.4.0 Sous Windows, le numéro du volume est maintenant le numéro de série qui contient le fichier, et le numéro de l'inode est l'identifiant associé avec le fichier.
7.4.0 Les valeurs statiques size, atime, mtime et ctime des liens symboliques sont toujours ceux de la cible. Ce n'était précédemment pas le cas pour les builds NTS sous Windows.

Exemples

Exemple #1 Exemple avec stat()

<?php
/* Récupération des informations */
$stat = stat('C:\php\php.exe');

/*
* Affichage de la date et heure de l'accès à ce fichier,
* identique à l'appel à la fonction fileatime()
*/
echo 'Date et heure d\'accès : ' . $stat['atime'];

/*
* Affiche de la date et heure de modification du fichier,
* identique à l'appel à la fonction filemtime()
*/
echo 'Date et heure de modification : ' . $stat['mtime'];

/* Affichage du numéro du device */
echo 'Numéro du Device : ' . $stat['dev'];
?>

Exemple #2 Utilisation des informations issues de stat() conjointement avec la fonction touch()

<?php
/* Récupération des informations issues de la fonction stat */
$stat = stat('C:\php\php.exe');

/* L'accès aux informations a-t-il échoué ? */
if (!$stat) {
echo 'L\'appel à stat() a échoué...';
} else {
/*
* Nous voulons que la date et heure d'accès soit d'une
* semaine après la date courante.
*/
$atime = $stat['atime'] + 604800;

/* Touchons le fichier ! */
if(!touch('some_file.txt', time(), $atime)) {
echo 'Échec lors de l\'appel à la fonction touch()...';
} else {
echo 'L\'appel à touch() a réussi...';
}
}
?>

Notes

Note:

Notez que la précision temporelle peut varier selon le système de fichiers utilisé.

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

Astuce

À partir de PHP 5.0.0, cette fonction peut aussi être utilisée avec quelques protocoles url. Lisez Liste des protocoles et des gestionnaires supportés pour connaître les protocoles supportant la famille de fonctionnalités de stat().

Voir aussi