(PHP 4, PHP 5, PHP 7, PHP 8)
lstat — Возвращает информацию о файле или символической ссылке
Собирает статистику на файл или символическую ссылку с именем
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(), смотрите в разделе Протоколы и обёртки.