PHP 文件函数

PHP stat() 函数 用来返回文件的统计信息。

如果是链接文件,它不统计链接文件的信息,而是统计原始文件的信息。

语法

stat(file)

参数

参数描述
file必需。规定要统计的文件信息路径。

返回值

成功返回指定的文件的统计信息,失败返回false
stat()fstat() 返回格式
数字下标关联键名(自 PHP 4.0.6)说明
0devdevice number - 设备名
1inoinode number - inode 号码
2modeinode protection mode - inode 保护模式
3nlinknumber of links - 被连接数目
4uiduserid of owner - 所有者的用户 id
5gidgroupid of owner- 所有者的组 id
6rdevdevice type, if inode device * - 设备类型,如果是 inode 设备的话
7sizesize in bytes - 文件大小的字节数
8atimetime of last access (unix timestamp) - 上次访问时间(Unix 时间戳)
9mtimetime of last modification (unix timestamp) - 上次修改时间(Unix 时间戳)
10ctimetime of last change (unix timestamp) - 上次改变时间(Unix 时间戳)
11blksizeblocksize of filesystem IO * - 文件系统 IO 的块大小
12blocksnumber of blocks allocated - 所占据块的数目

注意点

因为 PHP 的整数类型是有符号整型而且很多平台使用 32 位整型,对 2GB 以上的文件,一些文件系统函数可能返回无法预期的结果。

错误时会产生 E_WARNING 级别的错误。

例子

现介绍一个简单的例子了解该函数的使用方法。

<?php
print_r(stat('newTest.txt'));
?>  

输出:


Array
(
    [0] => 64769
    [1] => 1840260
    [2] => 33279
    [3] => 2
    [4] => 0
    [5] => 0
    [6] => 0
    [7] => 12
    [8] => 1683338546
    [9] => 1683165236
    [10] => 1683338536
    [11] => 4096
    [12] => 8
    [dev] => 64769
    [ino] => 1840260
    [mode] => 33279
    [nlink] => 2
    [uid] => 0
    [gid] => 0
    [rdev] => 0
    [size] => 12
    [atime] => 1683338546
    [mtime] => 1683165236
    [ctime] => 1683338536
    [blksize] => 4096
    [blocks] => 8
)