array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.lstat.php', 1 => 'lstat', 2 => 'Devuelve información sobre un fichero o un enlace simbólico', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.linkinfo.php', 1 => 'linkinfo', ), 'next' => array ( 0 => 'function.mkdir.php', 1 => 'mkdir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/lstat.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

lstat

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

lstat — Devuelve 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 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