stat

(PHP 3, PHP 4, PHP 5)

stat -- 給出檔案的訊息

說明

array stat ( string filename )

取得由 filename 特殊的檔案的統計訊息。若果 filename 是符號連線,則統計訊息是關於被連線檔案本身的,而不是符號連線。lstat()stat() 相同,只除了它會返回符號連線的狀態。

若果出錯,stat() 返回 FALSE,並且發出一條警示。

返回一個陣列包括有檔案的統計訊息,該陣列具有以下列出的單元,陣列下標從零開始。除了數字索引之外自 PHP 4.0.6 起還可以通過關聯索引來訪問。

表格 1. stat()fstat() 返回格式

數字下標關聯鍵名(自 PHP 4.0.6)說明
0devdevice number - 裝置名
1inoinode number - inode 號碼
2modeinode protection mode - inode 保護模式
3nlinknumber of links - 被連線數目
4uiduserid of owner - 所有者的會員id
5gidgroupid of owner- 所有者的組 id
6rdevdevice type, if inode device * - 裝置類型,若果是 inode 裝置的話
7sizesize in bytes - 檔案大小的位元組數
8atimetime of last access (unix timestamp) - 上次訪問時間(Unix 時間戳)
9mtimetime of last modification (unix timestamp) - 上次修改時間(Unix 時間戳)
10ctimetime of last change (unix timestamp) - 上次改變時間(Unix 時間戳)
11blksizeblocksize of filesystem IO * - 檔案系統 IO 的塊大小
12blocksnumber of blocks allocated - 所佔據塊的數目
* - 僅在支援 st_blksize 類型的系統下有效。其它系統(如 Windows)返回 -1。

注: 本函數的結果會被暫存。更多訊息參見 clearstatcache()

提示: PHP 5.0.0 起本函數也可被某些 URL wrapper 使用。參考附錄 M 來看哪些 wrapper 支援 stat() 系列函數的功能。

參見 lstat()fstat()filemtime()filegroup()