# lstat

(PHP 4, PHP 5, PHP 7)

lstat — 给出一个文件或符号连接的信息

### 说明

lstat ( string `$filename` ) : array

获取由 `filename` 指定的文件或符号连接的统计信息。

### 参数

`filename`

  文件或符号连接的路径。

### 返回值

有关 lstat() 返回的数组结构见手册中 stat() 函数的页面。 本函数和 stat() 函数相同，只除了如果 `filename` 参数是符号连接的话，则该符号连接的状态被返回，而不是该符号连接所指向的文件的状态。

### 范例

Example #1 stat() 和 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
    )

### 错误／异常

失败时抛出`E_WARNING`警告。

### 注释

> Note: 此函数的结果会被缓存。参见 clearstatcache() 以获得更多细节。

Tip

自 PHP 5.0.0 起, 此函数也用于某些 URL 包装器。请参见 支持的协议和封装协议以获得支持 stat() 系列函数功能的包装器列表。

### 参见

- stat() - 给出文件的信息