# lstat

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

lstat — Da información acerca de un archivo o enlace simbólico

### Descripción

lstat(string `$filename`): array

Reúne las estadísticas del archivo o enlace simbólico nombrado por `filename`.

### Parámetros

`filename`

  Ruta de un archivo o enlace simbólico.

### Valores devueltos

Vea la página del manual de stat() para información sobre la estructura de la matriz que devuelve lstat(). Esta función es idéntica a la función stat() excepto que si el parámetro `filename` es un enlace simbólico, se devuelve el estado del enlace simbólico, no el estado del archivo apuntado por el enlace simbólico.

### Ejemplos

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

`<?php
symlink('subidas.php', 'subidas');
// Contrastar la información de subidas.php y subidas
array_diff(stat('subidas'), lstat('subidas'));
?>`

El resultado del ejemplo sería algo similar a:

Información de difiere entre los dos archivos.

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

### Errores/Excepciones

En caso de fallo, se emite un `E_WARNING`.

### Notas

> Nota: Los resultados de esta función son guardados en caché. Para más información ver clearstatcache().

Sugerencia

Desde PHP 5.0.0, esta función también puede usarse con algunos URL wrappers. Consultar Protocolos y Envolturas soportados para deter4minar qué envolturas soportan la familia de funcionalidad de stat().

### Ver también

- stat() - Da información acerca de un fichero