PHP 提供豐富的檔案系統函式取得檔案元資料。本文整理常用函式並提供完整輸出範例。
| 函式 | 說明 | 回傳值 |
|---|---|---|
filesize() | 檔案大小(位元組) | int|false |
fileatime() | 最後存取時間 | Unix timestamp|false |
filemtime() | 最後內容修改時間 | Unix timestamp|false |
filectime() | 最後狀態改變時間(inode 變更) | Unix timestamp|false |
fileowner() | 檔案擁有者 UID | int|false |
filegroup() | 檔案群組 GID | int|false |
fileperms() | 檔案權限位元遮罩 | int|false |
filetype() | 檔案類型 | string|false |
<?php
$file = 'samplefile.doc';
if (!file_exists($file)) {
die("檔案不存在: $file");
}
$size = filesize($file);
$atime = fileatime($file);
$mtime = filemtime($file);
$ctime = filectime($file);
$perms = substr(sprintf('%o', fileperms($file)), -4);
echo "<p>檔案大小: " . human_readable_size($size) . "</p>";
echo "<p>最後存取: " . date('Y-m-d H:i:s', $atime) . "</p>";
echo "<p>最後修改: " . date('Y-m-d H:i:s', $mtime) . "</p>";
echo "<p>狀態變更: " . date('Y-m-d H:i:s', $ctime) . "</p>";
echo "<p>權限: $perms</p>";
function human_readable_size($bytes, $precision = 2) {
$units = ['B', 'KB', 'MB', 'GB', 'TB'];
$bytes = max($bytes, 0);
$pow = floor(($bytes ? log($bytes) : 0) / log(1024));
$pow = min($pow, count($units) - 1);
$bytes /= (1 << (10 * $pow));
return round($bytes, $precision) . ' ' . $units[$pow];
}
?>
filectime() 回傳建立時間;Linux/Unix 則是 inode 變更時間(非建立時間)。filesize() 可能回傳負數,建議使用 stat() 取得 size 欄位。stat() 或 spl_file_info 一次取得所有資訊。$info = new SplFileInfo($file);
echo $info->getSize();
echo $info->getATime();
echo $info->getMTime();
echo $info->getCTime();
echo $info->getPerms();
echo $info->getOwner();
echo $info->getGroup();
echo $info->getType();
SplFileInfo 物件導向介面更現代,且可直接搭配迭代器使用。