stat
Renvoie les informations à propos d'un fichier
&reftitle.description;
arrayfalsestat
stringfilename
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.
&reftitle.parameters;
filename
Le chemin vers le fichier.
&reftitle.returnvalues;
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 (e.g. Windows) retournent -1.
*** - Sous Windows, depuis 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ériques de la lettre
du volume (i.e. 2 pour C:) pour la fonction
stat, et 0 pour la fonction
lstat.
**** - Sous Windows, depuis 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éfinit en
fonction de l'attribut lecture seule du fichier, et la même valeur est
rapporté pour tout les utilisateurs, groupe, et propriétaire.
L'ACL n'est pas pris en compte, contrairement à is_writable.
La valeur de mode contient des informations lut par
plusieurs fonctions. Quand écrit en octal, commençant par la droite,
les trois premiers chiffres sont retournés par chmod.
Le prochain chiffre est ignoré par PHP. Les deux prochains chiffres 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
0040755.
En cas d'erreur, stat retourne &false;.
&fs.file.32bit;
&reftitle.errors;
Si une erreur survient, une alerte de type
E_WARNING est émise.
&reftitle.changelog;
&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.
&reftitle.examples;
Exemple avec stat
]]>
Utilisation des informations issues de stat
conjointement avec la fonction touch
]]>
&reftitle.notes;
¬e.filesystem-time-res;
¬e.clearstatcache;
&tip.fopen-wrapper.stat;
&reftitle.seealso;
lstat
fstat
filemtime
filegroup
SplFileInfo