stat

给出文件的信息 (PHP 3, PHP 4, PHP 5)
array stat ( string filename )

说明

获取由 filename 指定的文件的统计信息。如果 filename 是符号连接,则统计信息是关于被连接文件本身的,而不是符号连接。lstat()stat() 相同,只除了它会返回符号连接的状态。

如果出错,stat() 返回 FALSE,并且发出一条警告。

返回一个数组包含有文件的统计信息,该数组具有以下列出的单元,数组下标从零开始。除了数字索引之外自 PHP 4.0.6 起还可以通过关联索引来访问。

表 90. stat()fstat() 返回格式

数字下标关联键名(自 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 - 所占据块的数目

* - 仅在支持 st_blksize 类型的系统下有效。其它系统(如 Windows)返回 -1。

注意:

本函数的结果会被缓存。更多信息参见 clearstatcache()

提示:

PHP 5.0.0 起本函数也可被某些 URL wrapper 使用。参考附录 M, 支持的协议/封装协议列表 来看哪些 wrapper 支持 stat() 系列函数的功能。

参见 lstat()fstat()filemtime()filegroup()