Retourne les informations sur un fichier ou un lien symbolique

# lstat

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

lstat — Retourne les informations sur un fichier ou un lien symbolique

### Description

function lstat(string `$filename`): array|false

Rassemble les statistiques du fichier ou du lien symbolique désigné par `filename`.

### Liste de paramètres

`filename`

  Chemin vers un fichier ou un lien symbolique.

### Valeurs de retour

Se reporter à 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.

En cas d'échec, `false` est retourné.

### Erreurs / Exceptions

En cas d'échec, une alerte de type `E_WARNING` sera émise.

### Exemples

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
    )

### Notes

> 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

- stat() - Renvoie les informations à propos d'un fichier

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open