PHP stat() 函数

定义和用法

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

语法

fstat(file)
参数描述
file必需。规定要检查的文件。

说明

获取由 file 指定的文件的统计信息。如果 file 是符号连接,则统计信息是关于被连接文件本身的,而不是符号连接。

如果出错,stat() 返回 false,并且发出一条警告。

返回的数组包含有文件的统计信息,该数组具有以下列出的单元,数组下标从零开始。除了数字索引之外,从 PHP 4.0.6 起还可以通过关联索引来访问。

stat() 的返回格式

数字下标关联键名(自 PHP 4.0.6)说明
0dev设备名
1ino号码
2modeinode 保护模式
3nlink被连接数目
4uid所有者的用户 id
5gid所有者的组 id
6rdev设备类型,如果是 inode 设备的话
7size文件大小的字节数
8atime上次访问时间(Unix 时间戳)
9mtime上次修改时间(Unix 时间戳)
10ctime上次改变时间(Unix 时间戳)
11blksize文件系统 IO 的块大小
12blocks所占据块的数目

提示和注释

提示:lstat() 与 stat() 类似,不同的是,它会返回符号连接的状态。

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

实例

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

输出类似:

Array
(
[0] => 0
[1] => 0
[2] => 33206
[3] => 1
[4] => 0
[5] => 0
[6] => 0
[7] => 92
[8] => 1141633430
[9] => 1141298003
[10] => 1138609592
[11] => -1
[12] => -1
[dev] => 0
[ino] => 0
[mode] => 33206
[nlink] => 1
[uid] => 0
[gid] => 0
[rdev] => 0
[size] => 92
[atime] => 1141633430
[mtime] => 1141298003
[ctime] => 1138609592
[blksize] => -1
[blocks] => -1
)