PHP stat()関数

定義と用法

stat()関数はファイルに関する情報を返します。

文法

fstat(file)
パラメータ 説明
file 必須。チェックするファイルを指定します。

説明

file 指定されたファイルの統計情報 file シンボリックリンクの場合、統計情報はシンボリックリンク自体ではなく、リンク先のファイルに関するものです。

エラーが発生した場合、stat()はfalseを返し、警告を発行します。

返却する配列にはファイルの統計情報が含まれており、以下に示すユニットを持っています。配列インデックスはゼロから始まります。PHP 4.0.6からは、関連インデックスでもアクセスできます。

stat()の返却形式

数字インデックス 関連鍵名(PHP 4.0.6から) 説明
0 dev デバイス名
1 ino 番号
2 mode inode保護モード
3 nlink 接続数
4 uid 所有者のユーザID
5 gid 所有者のグループID
6 rdev デバイスのタイプ、inodeデバイスの場合
7 size ファイルのサイズ(バイト)
8 atime 前回アクセス時間(Unix時間スタンプ)
9 mtime 前回修正時間(Unix時間スタンプ)
10 ctime 前回変更時間(Unix時間スタンプ)
11 blksize 文件系统 IO 的块大小
12 blocks 所占据块的数目

提示和注释

提示: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
)