(PHP 4, PHP 5, PHP 7, PHP 8)
lstat — Retourne les informations sur un fichier ou un lien symbolique
$filename
): array|falseRetourne les informations sur un fichier ou un lien symbolique.
filename
Chemin vers un fichier ou un lien symbolique.
Voyez la page de manuel de stat() pour plus d'informations
sur la structure du tableau retourné par lstat().
Cette fonction est identique à la fonction stat() hormis
le fait que si filename
est un lien symbolique, les
informations seront alors basées sur le lien symbolique.
On failure, false
is returned.
En cas d'échec, une alerte de type E_WARNING
sera émise.
Exemple #1 Comparaison entre stat() et lstat()
<?php
symlink('uploads.php', 'uploads');
// On met en évidence la différence d'informations
array_diff(stat('uploads'), lstat('uploads'));
?>
Résultat de l'exemple ci-dessus est similaire à :
Informations qui diffèrent entre les 2 fichiers.
Array ( [ino] => 97236376 [mode] => 33188 [size] => 34 [atime] => 1223580003 [mtime] => 1223581848 [ctime] => 1223581848 [blocks] => 8 )
Note: Les résultats de cette fonction sont mis en cache. Voyez la fonction clearstatcache() pour plus de détails.
À 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().