函式名:dio_stat()
適用版本:PHP 7.0.0 及以上版本
函式描述:dio_stat() 函式用於獲取檔案的狀態資訊,包括檔案大小、建立時間、修改時間等。
語法:dio_stat(string $filename) : array|false
引數:
- $filename:要獲取狀態資訊的檔案路徑。
返回值:
- 如果成功,dio_stat() 函式返回一個關聯陣列,包括檔案的多個狀態資訊。
- 如果失敗,dio_stat() 函式返回 false。
狀態資訊陣列中可能包含以下鍵值對:
- "dev":裝置名
- "ino":i-node 索引號
- "mode":檔案的型別和許可權位
- "nlink":硬連結的數量
- "uid":檔案所有者的使用者 ID
- "gid":檔案所有者的使用者組 ID
- "rdev":特殊裝置名 (如果是特殊檔案)
- "size":檔案大小(位元組)
- "atime":最後訪問時間(Unix 時間戳)
- "mtime":最後修改時間(Unix 時間戳)
- "ctime":檔案狀態改變時間(Unix 時間戳)
- "blksize":I/O 緩衝區的大小
- "blocks":分配給檔案的塊數
示例:
$filename = "test.txt";
$fileInfo = dio_stat($filename);
if ($fileInfo !== false) {
echo "檔案大小:" . $fileInfo['size'] . " 位元組\n";
echo "最後修改時間:" . date('Y-m-d H:i:s', $fileInfo['mtime']) . "\n";
echo "最後訪問時間:" . date('Y-m-d H:i:s', $fileInfo['atime']) . "\n";
// 其他狀態資訊...
} else {
echo "獲取檔案狀態資訊失敗!\n";
}
以上示例獲取名為 "test.txt" 的檔案的狀態資訊,包括檔案大小、最後修改時間和最後訪問時間,並將其列印輸出。如果檔案操作失敗,則輸出相應提示資訊。