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() 與 stat() 類似,不同的是,它會返回符號連接的狀態。

注釋:本函數的結果會被緩存。請使用 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
)