lstat

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

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

Descripción

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 emite un 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'));
?>

El resultado del ejemplo sería algo 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 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() - Proporciona información sobre un fichero