Edit Report a Bug

    lstat

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

    lstat — Возвращает информацию о файле или символической ссылке

    Описание

    lstat(string $filename): array|false

    Собирает статистику на файл или символическую ссылку с именем filename.

    Список параметров

    filename

    Путь к файлу или символической ссылке.

    Возвращаемые значения

    Обратитесь к странице руководства функции stat() для получения информации о структуре массива, который возвращает lstat(). Эта функция идентична функции stat(), за исключением того, что если filename является символической ссылкой, возвращается статус символической ссылки, а не того файла, на который она указывает.

    Возвращает false в случае возникновения ошибки.

    Ошибки

    В случае неудачного завершения работы генерируется ошибка уровня E_WARNING.

    Примеры

    Пример #1 Сравнение функций stat() и lstat()

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

    // Отличия между uploads.php и uploads
    array_diff(stat('uploads'), lstat('uploads'));
    ?>

    Вывод приведённого примера будет похож на:

    Отличия в возвращаемых результатах между этими файлами. 

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

    Примечания

    Замечание: Результаты этой функции кешируются. Более подробную информацию смотрите в разделе clearstatcache().

    Подсказка

    Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обёртками url. Список обёрток, поддерживаемых семейством функций stat(), смотрите в разделе Поддерживаемые протоколы и обёртки.

    Смотрите также

    • stat() - Возвращает информацию о файле

    add a note add a note

    User Contributed Notes 2 notes

    up
    -1
    HP@SG
    4 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