# PHP stat() 函數 ## 定義和用法 stat() 函數返回關于文件的信息。 ### 語法 ``` fstat(file) ``` | 參數 | 描述 | | --- | --- | | file | 必需。規定要檢查的文件。 | ### 說明 獲取由 _file_ 指定的文件的統計信息。如果 _file_ 是符號連接，則統計信息是關于被連接文件本身的，而不是符號連接。 如果出錯，stat() 返回 false，并且發出一條警告。 返回的數組包含有文件的統計信息，該數組具有以下列出的單元，數組下標從零開始。除了數字索引之外，從 PHP 4.0.6 起還可以通過關聯索引來訪問。 ### stat() 的返回格式 | 數字下標 | 關聯鍵名（自 PHP 4.0.6） | 說明 | | --- | --- | --- | | 0 | dev | 設備名 | | 1 | ino | 號碼 | | 2 | mode | inode 保護模式 | | 3 | nlink | 被連接數目 | | 4 | uid | 所有者的用戶 id | | 5 | gid | 所有者的組 id | | 6 | rdev | 設備類型，如果是 inode 設備的話 | | 7 | size | 文件大小的字節數 | | 8 | atime | 上次訪問時間（Unix 時間戳） | | 9 | mtime | 上次修改時間（Unix 時間戳） | | 10 | ctime | 上次改變時間（Unix 時間戳） | | 11 | blksize | 文件系統 IO 的塊大小 | | 12 | blocks | 所占據塊的數目 | ## 提示和注釋 提示：[lstat()](/php/func_filesystem_lstat.asp "PHP lstat() 函數") 與 stat() 類似，不同的是，它會返回符號連接的狀態。 注釋：本函數的結果會被緩存。請使用 [clearstatcache()](/php/func_filesystem_clearstatcache.asp "PHP clearstatcache() 函數") 來清除緩存。 ## 例子 ``` <?php $file = fopen("test.txt","r"); print_r(stat($file)); fclose($file); ?> ``` 輸出類似： ``` Array ( [0] => 0 [1] => 0 [2] => 33206 [3] => 1 [4] => 0 [5] => 0 [6] => 0 [7] => 92 [8] => 1141633430 [9] => 1141298003 [10] => 1138609592 [11] => -1 [12] => -1 [dev] => 0 [ino] => 0 [mode] => 33206 [nlink] => 1 [uid] => 0 [gid] => 0 [rdev] => 0 [size] => 92 [atime] => 1141633430 [mtime] => 1141298003 [ctime] => 1138609592 [blksize] => -1 [blocks] => -1 ) ```