stat

PHP関数リファレンス

stat

(PHP 4, PHP 5)
stat — ファイルに関する情報を取得する

説明

array stat ( string filename )
filenameで指定されたファイルに ついての統計情報を取得します。 filename がシンボリックリンクの場合、 シンボリックリンクではなくファイルの実体の統計情報が返されます。 lstat() はシンボリックリンクの統計情報を返すという違いを除いて stat() と等価です。
stat() はエラーの場合 FALSE を返し、かつ warning を発行します。
ファイルの統計情報を、以下の要素を持つ配列として返します。 ゼロベース(添え字は数値)の配列に加えて、 各パラメータ毎の連想配列としてもアクセスできます。 これは PHP 4.0.6 以上で使用できます。
表 92. stat() と fstat()の 結果のフォーマット

数値	連想 (PHP 4.0.6 以上)	説明
0	dev	デバイス番号
1	ino	inode 番号
2	mode	inode プロテクトモード
3	nlink	リンク数
4	uid	所有者のユーザ ID
5	gid	所有者のグループ ID
6	rdev	inode デバイス の場合、デバイスの種類(*)
7	size	バイト単位のサイズ
8	atime	最終アクセス時間 (Unix タイムスタンプ)
9	mtime	最終修正時間 (Unix タイムスタンプ)
10	ctime	最終 inode 変更時間 (Unix タイムスタンプ)
11	blksize	ファイル IO のブロックサイズ(*)
12	blocks	ブロックの確保数

* st_blksize タイプをサポートするシステムでのみ有効です。 その他のシステム(例えば Windows)では -1 を返します。
注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。

ティップ

PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat() ファミリーをサポートしているか のリストについては、付録 M. サポートされるプロトコル/ラッパー を参照してください。
lstat()、 fstat()、 filemtime()、 filegroup() も参照してください。