# PHP stat() 函数 ## 定义和用法 stat() 函数返回关于文件的信息。 ### 语法 ``` fstat(file) ``` | 参数 | 描述 | | --- | --- | | file | 必需。规定要检查的文件。 | ### 说明 获取由 _file_ 指定的文件的统计信息。如果 _file_ 是符号连接，则统计信息是关于被连接文件本身的，而不是符号连接。 如果出错，stat() 返回 false，并且发出一条警告。 返回的数组包含有文件的统计信息，该数组具有以下列出的单元，数组下标从零开始。除了数字索引之外，从 PHP 4.0.6 起还可以通过关联索引来访问。 ### stat() 的返回格式 | 数字下标 | 关联键名（自 PHP 4.0.6） | 说明 | | --- | --- | --- | | 0 | dev | 设备名 | | 1 | ino | 号码 | | 2 | mode | inode 保护模式 | | 3 | nlink | 被连接数目 | | 4 | uid | 所有者的用户 id | | 5 | gid | 所有者的组 id | | 6 | rdev | 设备类型，如果是 inode 设备的话 | | 7 | size | 文件大小的字节数 | | 8 | atime | 上次访问时间（Unix 时间戳） | | 9 | mtime | 上次修改时间（Unix 时间戳） | | 10 | ctime | 上次改变时间（Unix 时间戳） | | 11 | blksize | 文件系统 IO 的块大小 | | 12 | blocks | 所占据块的数目 | ## 提示和注释 提示：[lstat()](/php/func_filesystem_lstat.asp "PHP lstat() 函数") 与 stat() 类似，不同的是，它会返回符号连接的状态。 注释：本函数的结果会被缓存。请使用 [clearstatcache()](/php/func_filesystem_clearstatcache.asp "PHP clearstatcache() 函数") 来清除缓存。 ## 例子 ``` <?php $file = fopen("test.txt","r"); print_r(stat($file)); fclose($file); ?> ``` 输出类似： ``` Array ( [0] => 0 [1] => 0 [2] => 33206 [3] => 1 [4] => 0 [5] => 0 [6] => 0 [7] => 92 [8] => 1141633430 [9] => 1141298003 [10] => 1138609592 [11] => -1 [12] => -1 [dev] => 0 [ino] => 0 [mode] => 33206 [nlink] => 1 [uid] => 0 [gid] => 0 [rdev] => 0 [size] => 92 [atime] => 1141633430 [mtime] => 1141298003 [ctime] => 1138609592 [blksize] => -1 [blocks] => -1 ) ```