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

# lstat

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

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

### Описание

function 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() - Возвращает информацию о файле

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open