lstat
(PHP 4, PHP 5, PHP 7, PHP 8)
lstat — 给出一个文件或符号连接的信息
说明
lstat(string
$filename): array
获取由 filename 指定的文件或符号连接的统计信息。
参数
-
filename -
文件或符号连接的路径。
返回值
有关 lstat()
返回的数组结构见手册中 stat() 函数的页面。
本函数和
stat() 函数相同，只除了如果
filename 参数是符号连接的话，则该符号连接的状态被返回，而不是该符号连接所指向的文件的状态。
范例
示例 #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警告。
注释
注意: 此函数的结果会被缓存。参见 clearstatcache() 以获得更多细节。
小技巧
自 PHP 5.0.0 起, 此函数也用于某些 URL 包装器。请参见 支持的协议和封装协议以获得支持 stat() 系列函数功能的包装器列表。
add a note
User Contributed Notes 2 notes
HP@SG ¶
1 year ago
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 ¶
6 years ago
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.