lstat
(PHP 4, PHP 5, PHP 7, PHP 8)
lstat — 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