stat

(PHP 3, PHP 4, PHP 5)

stat -- ファイルに関する情報を取得する

説明

array stat ( string filename )

filenameで指定されたファイルに ついての統計情報を取得します。 filename がシンボリックリンクの場合、 シンボリックリンクではなくファイルの実体の統計情報が返されます。 lstat() はシンボリックリンクの統計情報を返すという違いを除いて stat() と等価です。

stat() はエラーの場合 FALSE を返し、かつ warning を発行します。

ファイルの統計情報を、以下の要素を持つ配列として返します。 ゼロベース(添え字は数値)の配列に加えて、 各パラメータ毎の連想配列としてもアクセスできます。 これは PHP 4.0.6 以上で使用できます。

表 1. stat()fstat()の 結果のフォーマット

数値連想 (PHP 4.0.6 以上)説明
0devデバイス番号
1inoinode 番号
2modeinode プロテクトモード
3nlinkリンク数
4uid所有者のユーザ ID
5gid所有者のグループ ID
6rdevinode デバイス の場合、デバイスの種類(*)
7sizeバイト単位のサイズ
8atime最終アクセス時間 (Unix タイムスタンプ)
9mtime最終修正時間 (Unix タイムスタンプ)
10ctime最終 inode 変更時間 (Unix タイムスタンプ)
11blksizeファイル IO のブロックサイズ(*)
12blocksブロックの確保数
* st_blksize タイプをサポートするシステムでのみ有効です。 その他のシステム(例えば Windows)では -1 を返します。

注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。

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

lstat()fstat()filemtime()filegroup() も参照してください。