filenameで指定されたファイルに ついての統計情報を取得します。 filenameがシンボリックリンクの場合、 シンボリックリンクではなくファイルの実体の統計情報が返されます。 lstat()はシンボリックリンクの統計情報を返すという違いを除いて stat()と等価です。
stat()はエラーの場合 FALSE を返し、かつwarningを発行します。
ファイルの統計情報を、以下の要素を持つ配列として返します。 ゼロベース(添え字は数値)の配列に加えて、 各パラメータ毎の連想配列としてもアクセスできます。 これはPHP4.0.6以上で使用できます。
表 1. stat() と fstat()の 結果のフォーマット
| Numeric | Associative (since PHP 4.0.6) | 説明 |
|---|---|---|
| 0 | dev | device number |
| 1 | ino | inode number |
| 2 | mode | inode protection mode |
| 3 | nlink | number of links |
| 4 | uid | userid of owner |
| 5 | gid | groupid of owner |
| 6 | rdev | device type, if inode device * |
| 7 | size | size in bytes |
| 8 | atime | time of last access (unix timestamp) |
| 9 | mtime | time of last modification (unix timestamp) |
| 10 | ctime | time of last change (unix timestamp) |
| 11 | blksize | blocksize of filesystem IO * |
| 12 | blocks | number of blocks allocated |
注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照 して下さい。
注意: この関数では、 リモートファイルを 使用することはできません。これは、処理されるファイルがサーバーの ファイルシステムによりアクセスできる必要があるためです。
lstat(), fstat(), filemtime(), filegroup()も参照してください。