函式名稱:fstat()
函式描述:fstat() 函式用於返回開啟檔案的詳細資訊。
適用版本:所有 PHP 版本。
語法:fstat(file_handle)
引數:
- file_handle:必需。檔案控制代碼,即由 fopen() 返回的資源。
返回值:返回一個包含檔案資訊的關聯陣列,或者在失敗時返回 false。
關聯陣列的鍵值對如下:
- dev:檔案所在裝置的 ID。
- ino:檔案的 inode 號。
- mode:檔案的許可權和型別資訊。
- nlink:檔案的硬連結數目。
- uid:檔案的所有者的使用者 ID。
- gid:檔案的所有者的組 ID。
- rdev:如果檔案是一個特殊的裝置檔案,返回裝置號。
- size:檔案大小(以位元組為單位)。
- atime:最後訪問時間(Unix 時間戳)。
- mtime:最後修改時間(Unix 時間戳)。
- ctime:最後改變時間(Unix 時間戳)。
- blksize:檔案系統 I/O 的塊大小。
- blocks:檔案所佔用的塊數。
示例:
// 開啟檔案
$file = fopen("example.txt", "r");
// 獲取檔案資訊
$fileInfo = fstat($file);
// 輸出檔案大小
echo "檔案大小:" . $fileInfo['size'] . " 位元組";
// 關閉檔案
fclose($file);
注意事項:
- 使用 fstat() 函式前,需要先用 fopen() 函式開啟檔案,並獲得檔案控制代碼。
- 在使用完 fstat() 函式後,應使用 fclose() 函式關閉檔案控制代碼,以釋放資源。