Devuelve información sobre un fichero o un enlace simbólico

# lstat

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

lstat — Devuelve información sobre un fichero o un enlace simbólico

### Descripción

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

Devuelve información sobre un fichero o un enlace simbólico.

### Parámetros

`filename`

  Ruta de acceso a un fichero o un enlace simbólico.

### Valores devueltos

Consúltese la página del manual de stat() para obtener más información sobre la estructura del array devuelto por lstat(). Esta función es idéntica a la función stat() excepto que si `filename` es un enlace simbólico, la información se basará en el enlace simbólico.

En caso de error, se devuelve `false`.

### Errores/Excepciones

En caso de fallo, se emitirá una advertencia de tipo `E_WARNING`.

### Ejemplos

Ejemplo #1 Comparación entre stat() y lstat()

    <?php
    symlink('uploads.php', 'uploads');

    // Se destaca la diferencia de información
    array_diff(stat('uploads'), lstat('uploads'));
    ?>

Resultado del ejemplo anterior es similar a:

Información que difiere entre los 2 ficheros.

    Array
    (
        [ino] => 97236376
        [mode] => 33188
        [size] => 34
        [atime] => 1223580003
        [mtime] => 1223581848
        [ctime] => 1223581848
        [blocks] => 8
    )

### Notas

> Nota: Los resultados de esta función se almacenan en caché. Véase la función clearstatcache() para más detalles.

Sugerencia

A partir de PHP 5.0.0, esta función también puede ser utilizada con algunos protocolos url. Lea Protocolos y Envolturas soportados para conocer los protocolos que soportan la familia de funcionalidades de stat().

### Ver también

- stat() - Proporciona información sobre un fichero

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