stat
(PHP 4, PHP 5, PECL maxdb:7.5.00.24-7.6.00.38)
stat — ファイルに関する情報を取得する
説明
array stat
( string $filename
)
filename で指定されたファイルに ついての統計情報を取得します。 filename がシンボリックリンクの場合、 シンボリックリンクではなくファイルの実体の統計情報が返されます。
lstat() はシンボリックリンクの統計情報を返すという違いを除いて stat() と等価です。
パラメータ
- filename
-
ファイルへのパス。
返り値
| 数値 | 連想 (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 を返します。
stat() はエラーの場合 FALSE を返します。
エラー / 例外
失敗した場合は E_WARNING が発生します。
変更履歴
| バージョン | 説明 |
|---|---|
| 4.0.6 | 数値添字の配列に加えて、 各パラメータ毎の連想配列としてもアクセスできるようになりました。 |
注意
注意: 時刻の精度は、 ファイルシステムによって異なることがあります。
注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。
ヒント
PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat() ファミリーをサポートしているか のリストについては、サポートされるプロトコル/ラッパー を参照してください。