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 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 están 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