PHP stat() 函数

定义和用法

stat() 函数返回关于文件的信息。

语法

  1. 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() 与 stat() 类似,不同的是,它会返回符号连接的状态。

注释:本函数的结果会被缓存。请使用 clearstatcache() 来清除缓存。

例子

  1. <?php
  2. $file = fopen("test.txt","r");
  3. print_r(stat($file));
  4. fclose($file);
  5. ?>

输出类似:

  1. Array
  2. (
  3. [0] => 0
  4. [1] => 0
  5. [2] => 33206
  6. [3] => 1
  7. [4] => 0
  8. [5] => 0
  9. [6] => 0
  10. [7] => 92
  11. [8] => 1141633430
  12. [9] => 1141298003
  13. [10] => 1138609592
  14. [11] => -1
  15. [12] => -1
  16. [dev] => 0
  17. [ino] => 0
  18. [mode] => 33206
  19. [nlink] => 1
  20. [uid] => 0
  21. [gid] => 0
  22. [rdev] => 0
  23. [size] => 92
  24. [atime] => 1141633430
  25. [mtime] => 1141298003
  26. [ctime] => 1138609592
  27. [blksize] => -1
  28. [blocks] => -1
  29. )