PHP stat() 函數(shù)
定義和用法
stat() 函數(shù)返回關(guān)于文件的信息。
語法
fstat(file)
| 參數(shù) | 描述 |
|---|---|
| file | 必需。規(guī)定要檢查的文件。 |
說明
獲取由 file 指定的文件的統(tǒng)計(jì)信息。如果 file 是符號連接,則統(tǒng)計(jì)信息是關(guān)于被連接文件本身的,而不是符號連接。
如果出錯(cuò),stat() 返回 false,并且發(fā)出一條警告。
返回的數(shù)組包含有文件的統(tǒng)計(jì)信息,該數(shù)組具有以下列出的單元,數(shù)組下標(biāo)從零開始。除了數(shù)字索引之外,從 PHP 4.0.6 起還可以通過關(guān)聯(lián)索引來訪問。
stat() 的返回格式
| 數(shù)字下標(biāo) | 關(guān)聯(lián)鍵名(自 PHP 4.0.6) | 說明 |
|---|---|---|
| 0 | dev | 設(shè)備名 |
| 1 | ino | 號碼 |
| 2 | mode | inode 保護(hù)模式 |
| 3 | nlink | 被連接數(shù)目 |
| 4 | uid | 所有者的用戶 id |
| 5 | gid | 所有者的組 id |
| 6 | rdev | 設(shè)備類型,如果是 inode 設(shè)備的話 |
| 7 | size | 文件大小的字節(jié)數(shù) |
| 8 | atime | 上次訪問時(shí)間(Unix 時(shí)間戳) |
| 9 | mtime | 上次修改時(shí)間(Unix 時(shí)間戳) |
| 10 | ctime | 上次改變時(shí)間(Unix 時(shí)間戳) |
| 11 | blksize | 文件系統(tǒng) IO 的塊大小 |
| 12 | blocks | 所占據(jù)塊的數(shù)目 |
提示和注釋
提示:lstat() 與 stat() 類似,不同的是,它會(huì)返回符號連接的狀態(tài)。
注釋:本函數(shù)的結(jié)果會(huì)被緩存。請使用 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 )