PHP stat 文件系统函数
定义和用法
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:\php\php.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() - 取得文件的组