PHP 文件函数

PHP lstat() 函数 用来返回文件或符号连接(软连接)统计信息。linux中软链接概念和创建请参考这里

它不同于PHP stat() 函数 它可以统计链接文件的信息。

语法

lstat(file)

参数

参数描述
file必需。规定要统计的文件或符号连接(软连接)信息路径。

返回值

成功返回指定的文件或符号连接(软连接)的统计信息,失败返回false
lstat()flstat() 返回格式
数字下标关联键名(自 PHP 4.0.6)说明
0devdevice number - 设备名
1inoinode number - inode 号码
2modeinode protection mode - inode 保护模式
3nlinknumber of links - 被连接数目
4uiduserid of owner - 所有者的用户 id
5gidgroupid of owner- 所有者的组 id
6rdevdevice type, if inode device * - 设备类型,如果是 inode 设备的话
7sizesize in bytes - 文件大小的字节数
8atimetime of last access (unix timestamp) - 上次访问时间(Unix 时间戳)
9mtimetime of last modification (unix timestamp) - 上次修改时间(Unix 时间戳)
10ctimetime of last change (unix timestamp) - 上次改变时间(Unix 时间戳)
11blksizeblocksize of filesystem IO * - 文件系统 IO 的块大小
12blocksnumber of blocks allocated - 所占据块的数目

注意点

错误时会产生 E_WARNING 级别的错误。

例子

现介绍一个简单的例子了解该函数的使用方法。

在此之前我们先使用ln命令创建一个软链接文件。

ln -s test.txt test

如图所示:

PHP lstat() 函数

上面的截图中,软连接文件test指向原始文件test.txt

您也可以使用PHP symlink() 函数创建一个软连接文件。

下面是lstat() 函数的例子:

<?php
print_r(lstat('test'));
?>  

输出:

Array
(
    [0] => 64769
    [1] => 1841585
    [2] => 41471
    [3] => 1
    [4] => 0
    [5] => 0
    [6] => 0
    [7] => 8
    [8] => 1683341407
    [9] => 1683341407
    [10] => 1683341407
    [11] => 4096
    [12] => 0
    [dev] => 64769
    [ino] => 1841585
    [mode] => 41471
    [nlink] => 1
    [uid] => 0
    [gid] => 0
    [rdev] => 0
    [size] => 8
    [atime] => 1683341407
    [mtime] => 1683341407
    [ctime] => 1683341407
    [blksize] => 4096
    [blocks] => 0
)