stat
(PHP 4, PHP 5, PECL maxdb:7.5.00.24-7.6.00.38)
stat — Gives information about a file
說明
array stat
( string $filename
)
Gathers the statistics of the file named by filename . If filename is a symbolic link, statistics are from the file itself, not the symlink.
lstat() is identical to stat() except it would instead be based off the symlinks status.
參數
- filename
-
Path to the file.
Return值
| Numeric | Associative (since PHP 4.0.6) | Description |
|---|---|---|
| 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 inode change (Unix timestamp) |
| 11 | blksize | blocksize of filesystem IO * |
| 12 | blocks | number of blocks allocated * |
In case of error, stat() returns FALSE.
錯誤/例外
Upon failure, an E_WARNING is emitted.
更新日誌
| 版本 | 說明 |
|---|---|
| 4.0.6 | In addition to returning these attributes in a numeric array, they can be accessed with associative indices, as noted next to each parameter |
註釋
Note: 本函式的結果會被存入緩衝區。詳情參見 clearstatcache()。
Tip
自 PHP 5.0.0 起本函式也可被某些 URL wrapper 使用。參考List of Supported Protocols/Wrappers 來看哪些 wrapper 支援 stat() 系列函式的功能。