stat()

1. 定义

该函数返回一个文件的所有统计信息。 成功时返回统计信息的数组,失败则返回FALSE。

注:

  • Windows系统下的文件inode编号都显示为0。
  • 该函数结果会被缓存,若需要清除缓存,请使用clearstatcache()函数。

2. 语法

stat ( string $filepath ) : array

3. 参数说明

参数 可选性 数据类型 描述
$filepath 必需 字符串 指定的文件所在路径

4. 示例

<?php

// stat()
// 返回一个文件的所有统计信息

$filepath = __FILE__;
$stat = stat($filepath);
echo '设备号:',$stat['dev'],"\n";
echo 'inode编号:',$stat['ino'],"\n";
echo '文件权限值:',$stat['mode'],"\n";
echo '文件被连接数目:',$stat['nlink'],"\n";
echo '所有者用户ID:',$stat['uid'],"\n";
echo '所在组ID:',$stat['gid'],"\n";
echo '设备类型:',$stat['rdev'],"\n";
echo '文件的大小字节数:',$stat['size'],"\n";
echo '上一次的访问时间:',$stat['atime'],"\n";
echo '上一次的修改时间:',$stat['mtime'],"\n";
echo '上一次inode编号的修改时间:',$stat['ctime'],"\n";
echo '文件系统IO的块大小:',$stat['blksize'],"\n";
echo '所占据块的数量:',$stat['blocks'],"\n";

/* 输出:
设备号:4
inode编号:0
文件权限值:33206
文件被连接数目:1
所有者用户ID:0
所在组ID:0
设备类型:4
文件的大小字节数:786
上一次的访问时间:1577694714
上一次的修改时间:1577694712
上一次inode编号的修改时间:1577694166
文件系统IO的块大小:-1
所占据块的数量:-1
*/

// var_dump($stat);

5. 延展阅读

  • lstat():返回文件或符号链接的统计信息
  • fstat():返回通过fopen()函数打开的文件句柄的本地文件的信息
  • filemtime():返回指定文件的上一次修改时间
  • filegroup():获取指定文件所在组的 ID 值