Saltar al contenido

lstat()

¿Qué es la función lstat()?

La función lstat() devuelve metadatos sobre un enlace simbólico. A diferencia de stat(), que sigue el enlace y devuelve información sobre el archivo de destino, lstat() devuelve información sobre el propio enlace.

A continuación se muestra la sintaxis básica de la función lstat():

La sintaxis de lstat() en PHP

php
array lstat(string $filename): array|false

Donde $filename es la ruta al enlace simbólico.

¿Cómo usar la función lstat()?

El uso de la función lstat() es sencillo. Sigue estos pasos:

  1. Especifica la ruta del enlace simbólico que deseas inspeccionar.
  2. Llama a la función lstat(), pasando la ruta como parámetro.
  3. Verifica el valor devuelto, ya que la función devuelve false en caso de error.

A continuación se muestra un fragmento de código de ejemplo que demuestra cómo usar la función lstat():

¿Cómo usar la función lstat()?

php
<?php

$link = '/path/to/symbolic/link';
$info = lstat($link);

if ($info === false) {
    echo "Failed to get information about the symbolic link.";
} else {
    echo "The link has a size of {$info['size']} bytes.";
}

La función devuelve un array asociativo que contiene las mismas claves que stat(): dev, ino, mode, nlink, uid, gid, rdev, size, atime, mtime, ctime, blksize y blocks. Acceder a ellas por nombre (por ejemplo, `$info['size']`) es más seguro y legible que usar índices numéricos.

Nota: Asegúrate de que tu proceso de PHP tenga permisos de lectura para el directorio que contiene el enlace simbólico. En algunos sistemas, acceder a los metadatos de un enlace simbólico puede requerir privilegios elevados o configuraciones específicas de módulos de seguridad.

Conclusión

La función lstat() es una herramienta útil en PHP para obtener información sobre enlaces simbólicos en un sistema de archivos. Siguiendo los pasos descritos en esta guía, podrás usar fácilmente la función lstat() en tus proyectos de PHP para obtener información sobre enlaces simbólicos. Esperamos que esta guía te haya sido de utilidad.

Práctica

¿Cuál es la función de lstat() en PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.