PHP 手册
后退 |  | 前进

# stat

(PHP 3, PHP 4, PHP 5)

stat -- 给出文件的信息

## 说明

array stat ( string filename )

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

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

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

表格 1. stat() 和 fstat() 返回格式

数字下标 | 关联键名（自 PHP 4.0.6） | 说明
--- | --- | ---
0 | dev | device number - 设备名
1 | ino | inode number - inode 号码
2 | mode | inode protection mode - inode 保护模式
3 | nlink | number of links - 被连接数目
4 | uid | userid of owner - 所有者的用户id
5 | gid | groupid of owner- 所有者的组 id
6 | rdev | device type, if inode device * - 设备类型，如果是 inode 设备的话
7 | size | size in bytes - 文件大小的字节数
8 | atime | time of last access (unix timestamp) - 上次访问时间（Unix 时间戳）
9 | mtime | time of last modification (unix timestamp) - 上次修改时间（Unix 时间戳）
10 | ctime | time of last change (unix timestamp) - 上次改变时间（Unix 时间戳）
11 | blksize | blocksize of filesystem IO * - 文件系统 IO 的块大小
12 | blocks | number of blocks allocated - 所占据块的数目

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

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

> 提示: 自 PHP 5.0.0 起本函数也可被某些 URL wrapper 使用。参考附录 L 来看哪些 wrapper 支持 stat() 系列函数的功能。

参见 lstat()，fstat()，filemtime() 和 filegroup()。

后退 | 起点 | 前进
set_file_buffer | 上一级 | symlink