lstat
(PHP 4, PHP 5, PHP 7)
lstat — Возвращает информацию о файле или символической ссылке
Описание
$filename
) : array|false
Собирает статистику на файл или символическую ссылку с именем
filename.
Список параметров
-
filename -
Путь к файлу или символической ссылке.
Возвращаемые значения
Обратитесь к странице руководства функции stat() для
получения информации о структуре массива, который возвращает
lstat(). Эта функция идентична функции
stat(), за исключением того, что если
filename является символической ссылкой,
возвращается статус символической ссылки, а не того файла, на
который она указывает.
Возвращает false в случае возникновения ошибки.
Примеры
Пример #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
)
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING.
Примечания
Замечание: Результаты этой функции кешируются. Более подробную информацию смотрите в разделе clearstatcache().
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обертками url. Список оберток, поддерживаемых семейством функций stat(), смотрите в разделе Поддерживаемые протоколы и обертки.