定义和用法
stat - 给出文件的信息
版本支持
| PHP4 | PHP5 | PHP7 |
|---|---|---|
| 支持 | 支持 | 支持 |
语法
stat ( string $filename )
获取由 filename 指定的文件的统计信息。如果 filename 是符号连接，则统计信息是关于被连接文件本身的，而不是符号连接。 lstat() 和 stat() 相同，只除了它会返回符号连接的状态。
参数
| 参数 | 必需的 | 描述 |
|---|---|---|
| filename | 是 | 文件的路径。 |
返回值
| 数字下标 | 关联键名 | 描述 |
|---|---|---|
| 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 - 所占据块的数目 |
* Windows 下总是 0。
* - 仅在支持 st_blksize 类型的系统下有效。其它系统（如 Windows）返回 -1。
如果出错，stat() 返回 FALSE。
注意: 因为 PHP 的整数类型是有符号整型而且很多平台使用 32 位整型，对 2GB 以上的文件，一些文件系统函数可能返回无法预期的结果 。
示例
<?php
/* 获取文件信息 */
$stat = stat('C:phpphp.exe');
/*
* 打印文件的访问时间，这是一样的
* as calling fileatime()
*/
echo 'Access time: ' . $stat['atime'];
/*
* 打印文件修改时间，这是
* same as calling filemtime()
*/
echo 'Modification time: ' . $stat['mtime'];
/* 打印设备号 */
echo 'Device number: ' . $stat['dev'];
相关函数
lstat() - 给出一个文件或符号连接的信息
fstat() - 通过已打开的文件指针取得文件信息
filemtime() - 取得文件修改时间
filegroup() - 取得文件的组