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() - 取得文件的组