lstat

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

lstat — Gives information about a file or symbolic link

Опис

lstat(string $filename): array|false

Gathers the statistics of the file or symbolic link named by filename.

Параметри

filename: Path to a file or a symbolic link.

Значення, що повертаються

See the manual page for stat() for information on the structure of the array that lstat() returns. This function is identical to the stat() function except that if the filename parameter is a symbolic link, the status of the symbolic link is returned, not the status of the file pointed to by the symbolic link.

On failure, false is returned.

Помилки/виключення

Під час збоїв буде видаватись E_WARNING.

Приклади

Приклад #1 Comparison of stat() and lstat()

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

// Contrast information for uploads.php and uploads
array_diff(stat('uploads'), lstat('uploads'));
?>

Поданий вище приклад виведе щось схоже на:

Information that differs between the two files.

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

Примітки

Зауваження: Рузультати цієї функції кешуються. Докладніше: clearstatcache().

Підказка

Починаючи з PHP 5.0.0, ця функція також може бути використана з деякими URL-обгортками. На сторінці Підтримувані протоколи та обгортки вказано, які обгортки підтримують сімейство функцій stat().

Прогляньте також

stat() - Gives information about a file