函数名称:fstat()
函数描述:fstat() 函数用于返回打开文件的详细信息。
适用版本:所有 PHP 版本。
语法:fstat(file_handle)
参数:
- file_handle:必需。文件句柄,即由 fopen() 返回的资源。
返回值:返回一个包含文件信息的关联数组,或者在失败时返回 false。
关联数组的键值对如下:
- dev:文件所在设备的 ID。
- ino:文件的 inode 号。
- mode:文件的权限和类型信息。
- nlink:文件的硬链接数目。
- uid:文件的所有者的用户 ID。
- gid:文件的所有者的组 ID。
- rdev:如果文件是一个特殊的设备文件,返回设备号。
- size:文件大小(以字节为单位)。
- atime:最后访问时间(Unix 时间戳)。
- mtime:最后修改时间(Unix 时间戳)。
- ctime:最后改变时间(Unix 时间戳)。
- blksize:文件系统 I/O 的块大小。
- blocks:文件所占用的块数。
示例:
// 打开文件
$file = fopen("example.txt", "r");
// 获取文件信息
$fileInfo = fstat($file);
// 输出文件大小
echo "文件大小:" . $fileInfo['size'] . " 字节";
// 关闭文件
fclose($file);
注意事项:
- 使用 fstat() 函数前,需要先用 fopen() 函数打开文件,并获得文件句柄。
- 在使用完 fstat() 函数后,应使用 fclose() 函数关闭文件句柄,以释放资源。