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