lstat

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

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() - 给出文件的信息

User Contributed Notes

HP@SG 11-Nov-2020 06:47


Just for information and in reply to a previous message left 4 years ago by "salsi at icosaedro dot it" :



Files larger than 2 GiB can be handled on 64-bit Linux systems.



My test in a terminal is as follow (using <?php ;?> tags to colour the results for ease of reading) :



$ php -v



<?php

"

PHP 7.2.24-0ubuntu0.18.04.7 (cli) (built: Oct  7 2020 15:24:25) ( NTS )

Copyright (c) 1997-2018 The PHP Group

Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies

    with Zend OPcache v7.2.24-0ubuntu0.18.04.7, Copyright (c) 1999-2018, by Zend Technologies

"

;?>



$ date ; dd if=/dev/zero of=/tmp/php_test_huge bs=1024K count=2100 ; date ; ls -l /tmp/php_test_huge



<?php

"

Wed Nov 11 15:35:46 +08 2020

2100+0 records in

2100+0 records out

2202009600 bytes (2.2 GB, 2.1 GiB) copied, 4.79192 s, 460 MB/s

Wed Nov 11 15:35:51 +08 2020

-rw-r--r-- 1 harold harold 2202009600 Nov 11 15:35 /tmp/php_test_huge

"

;?>



$ php -r 'var_dump(lstat("/tmp/php_test_huge"));'



<?php

"

array(26) {

  [0]=>

  int(2050)

  [1]=>

  int(19923027)

  [2]=>

  int(33188)

  [3]=>

  int(1)

  [4]=>

  int(1000)

  [5]=>

  int(1000)

  [6]=>

  int(0)

  [7]=>

  int(2202009600)

  [8]=>

  int(1605079647)

  [9]=>

  int(1605080149)

  [10]=>

  int(1605080149)

  [11]=>

  int(4096)

  [12]=>

  int(4300808)

  ["dev"]=>

  int(2050)

  ["ino"]=>

  int(19923027)

  ["mode"]=>

  int(33188)

  ["nlink"]=>

  int(1)

  ["uid"]=>

  int(1000)

  ["gid"]=>

  int(1000)

  ["rdev"]=>

  int(0)

  ["size"]=>

  int(2202009600)

  ["atime"]=>

  int(1605079647)

  ["mtime"]=>

  int(1605080149)

  ["ctime"]=>

  int(1605080149)

  ["blksize"]=>

  int(4096)

  ["blocks"]=>

  int(4300808)

}

"

;?>

salsi at icosaedro dot it 07-Jan-2016 07:29


This function fails and returns FALSE with files larger than 2 GB on Linux 32-bits (PHP 7.1.0-dev):



    $ dd if=/dev/zero of=/tmp/huge bs=1048576 count=2050

    $ php -r 'var_dump(lstat("/tmp/huge"));'

    --> Warning: lstat(): Lstat failed for /tmp/huge in Command line code on line 1



Window not tested. PHP 64-bits not tested.