說明
array
stat ( string filename )
取得由 filename 特殊的檔案的統計訊息。若果
filename
是符號連線,則統計訊息是關於被連線檔案本身的,而不是符號連線。lstat()
和 stat() 相同,只除了它會返回符號連線的狀態。
若果出錯,stat() 返回 FALSE,並且發出一條警示。
返回一個陣列包括有檔案的統計訊息,該陣列具有以下列出的單元,陣列下標從零開始。除了數字索引之外自
PHP 4.0.6 起還可以通過關聯索引來訪問。
表格 1. stat() 和 fstat() 返回格式
數字下標 | 關聯鍵名(自 PHP 4.0.6) | 說明 |
---|
0 | dev | device number - 裝置名 |
1 | ino | inode number - inode 號碼 |
2 | mode | inode protection mode - inode 保護模式 |
3 | nlink | number of links - 被連線數目 |
4 | uid | userid of owner - 所有者的會員id |
5 | gid | groupid of owner- 所有者的組 id |
6 | rdev | device type, if inode device * - 裝置類型,若果是 inode 裝置的話 |
7 | size | size in bytes - 檔案大小的位元組數 |
8 | atime | time of last access (unix timestamp) - 上次訪問時間(Unix 時間戳) |
9 | mtime | time of last modification (unix timestamp) - 上次修改時間(Unix 時間戳) |
10 | ctime | time of last change (unix timestamp) - 上次改變時間(Unix 時間戳) |
11 | blksize | blocksize of filesystem IO * - 檔案系統 IO 的塊大小 |
12 | blocks | number of blocks allocated - 所佔據塊的數目 |
* - 僅在支援 st_blksize 類型的系統下有效。其它系統(如 Windows)返回 -1。
提示: 自 PHP 5.0.0
起本函數也可被某些 URL wrapper 使用。參考附錄 M 來看哪些 wrapper 支援
stat() 系列函數的功能。
參見 lstat(),fstat(),filemtime() 和
filegroup()。