Edit Report a Bug

    lstat

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

    lstat — Da información acerca de un archivo o enlace simbólico

    Descripción

    lstat(string $filename): array

    Reúne las estadísticas del archivo o enlace simbólico nombrado por filename.

    Parámetros

    filename

    Ruta de un archivo o enlace simbólico.

    Valores devueltos

    Vea la página del manual de stat() para información sobre la estructura de la matriz que devuelve lstat(). Esta función es idéntica a la función stat() excepto que si el parámetro filename es un enlace simbólico, se devuelve el estado del enlace simbólico, no el estado del archivo apuntado por el enlace simbólico.

    Ejemplos

    Ejemplo #1 Comparación de stat() y lstat()

    <?php
    symlink    ('subidas.php', 'subidas');

    // Contrastar la información de subidas.php y subidas
    array_diff(stat('subidas'), lstat('subidas'));
    ?>

    El resultado del ejemplo sería algo similar a:

    Información de difiere entre los dos archivos. 

    Array
(
    [ino] => 97236376
    [mode] => 33188
    [size] => 34
    [atime] => 1223580003
    [mtime] => 1223581848
    [ctime] => 1223581848
    [blocks] => 8
)

    Errores/Excepciones

    En caso de fallo, se emite un E_WARNING.

    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() - Da información acerca de un fichero

    add a note add a note

    User Contributed Notes 2 notes

    up
    -1
    HP@SG
    3 years ago
    Just for information and in reply to a previous message left 4 years ago by "salsi at icosaedro dot it" :

    Files larger than 2 GiB can be handled on 64-bit Linux systems.

    My test in a terminal is as follow (using <?php ;?> tags to colour the results for ease of reading) :

    $ php -v

    <?php
    "
    PHP 7.2.24-0ubuntu0.18.04.7 (cli) (built: Oct  7 2020 15:24:25) ( NTS )
    Copyright (c) 1997-2018 The PHP Group
    Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
        with Zend OPcache v7.2.24-0ubuntu0.18.04.7, Copyright (c) 1999-2018, by Zend Technologies
    "
    ;?>

    $ date ; dd if=/dev/zero of=/tmp/php_test_huge bs=1024K count=2100 ; date ; ls -l /tmp/php_test_huge

    <?php
    "
    Wed Nov 11 15:35:46 +08 2020
    2100+0 records in
    2100+0 records out
    2202009600 bytes (2.2 GB, 2.1 GiB) copied, 4.79192 s, 460 MB/s
    Wed Nov 11 15:35:51 +08 2020
    -rw-r--r-- 1 harold harold 2202009600 Nov 11 15:35 /tmp/php_test_huge
    "
    ;?>

    $ php -r 'var_dump(lstat("/tmp/php_test_huge"));'

    <?php
    "
    array(26) {
      [0]=>
      int(2050)
      [1]=>
      int(19923027)
      [2]=>
      int(33188)
      [3]=>
      int(1)
      [4]=>
      int(1000)
      [5]=>
      int(1000)
      [6]=>
      int(0)
      [7]=>
      int(2202009600)
      [8]=>
      int(1605079647)
      [9]=>
      int(1605080149)
      [10]=>
      int(1605080149)
      [11]=>
      int(4096)
      [12]=>
      int(4300808)
      ["    dev"]=>
      int(2050)
      ["    ino"]=>
      int(19923027)
      ["    mode"]=>
      int(33188)
      ["    nlink"]=>
      int(1)
      ["    uid"]=>
      int(1000)
      ["    gid"]=>
      int(1000)
      ["    rdev"]=>
      int(0)
      ["    size"]=>
      int(2202009600)
      ["    atime"]=>
      int(1605079647)
      ["    mtime"]=>
      int(1605080149)
      ["    ctime"]=>
      int(1605080149)
      ["    blksize"]=>
      int(4096)
      ["    blocks"]=>
      int(4300808)
    }
    "
    ;?>
    up
    -3
    salsi at icosaedro dot it
    8 years ago
    This function fails and returns FALSE with files larger than 2 GB on Linux 32-bits (PHP 7.1.0-dev):

        $ dd if=/dev/zero of=/tmp/huge bs=1048576 count=2050
        $ php -r 'var_dump(lstat("/tmp/huge"));'
        --> Warning: lstat(): Lstat failed for /tmp/huge in Command line code on line 1

    Window not tested. PHP 64-bits not tested.
    add a note add a note
    To Top