在 Web 頁面顯示文件大小、流量統計等數值時,需根據大小自動切換單位(B/KB/MB/GB...)並保留適當精度。本文提供一個遞歸版與非遞歸版 formatSize() 函數,支援從 Byte 到 Yottabyte (YB) 的完整單位體系。
function formatSize($bytes, $times = 0) {
if ($bytes > 1024) {
return formatSize($bytes / 1024, $times + 1);
} else {
$units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
$unit = $units[$times] ?? '未知單位';
return sprintf('%.2f', $bytes) . $unit;
}
}
echo formatSize(20667564); // 19.71MB
function formatSize($bytes, $precision = 2) {
$bytes = max((float)$bytes, 0);
$units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
$pow = $bytes > 0 ? floor(log($bytes, 1024)) : 0;
$pow = min($pow, count($units) - 1);
$value = $bytes / (1024 ** $pow);
return round($value, $precision) . ' ' . $units[$pow];
}
// 測試
$tests = [0, 512, 1024, 1536, 1048576, 1073741824, 1099511627776, 1.2e18];
foreach ($tests as $b) {
echo "$b => " . formatSize($b) . "\n";
}
/*
0 => 0.00 B
512 => 512.00 B
1024 => 1.00 KB
1536 => 1.50 KB
1048576 => 1.00 MB
1073741824 => 1.00 GB
1099511627776 => 1.00 TB
1.2E+18 => 1058791.18 PB (接近 EB)
*/
| 單位 | 符號 | 倍數 (1024^n) | 十進制近似 |
|---|---|---|---|
| Byte | B | 1024^0 | 1 B |
| Kibibyte | KiB / KB | 1024^1 | 1,024 B |
| Mebibyte | MiB / MB | 1024^2 | 1,048,576 B |
| Gibibyte | GiB / GB | 1024^3 | 1,073,741,824 B |
| Tebibyte | TiB / TB | 1024^4 | 1.0995e12 B |
| Pebibyte | PiB / PB | 1024^5 | 1.1259e15 B |
| Exbibyte | EiB / EB | 1024^6 | 1.1529e18 B |
| Zebibyte | ZiB / ZB | 1024^7 | 1.1806e21 B |
| Yobibyte | YiB / YB | 1024^8 | 1.2089e24 B |
註:IEC 標準建議 KiB/MiB/GiB 表示 1024 進制,KB/MB/GB 表示 1000 進制。本函數按 1024 進制計算,單位沿用常見 KB/MB/GB 寫法。
function formatSizeSI($bytes, $precision = 2, $binary = true) {
$bytes = max((float)$bytes, 0);
$base = $binary ? 1024 : 1000;
$units = $binary
? ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB']
: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
$pow = $bytes > 0 ? floor(log($bytes, $base)) : 0;
$pow = min($pow, count($units) - 1);
$value = $bytes / ($base ** $pow);
return round($value, $precision) . ' ' . $units[$pow];
}
echo formatSizeSI(1000000); // 976.56 KiB (二進制)
echo formatSizeSI(1000000, 2, false); // 1.00 MB (十進制,硬盤廠商標稱)
$precision 可根據 UI 需求調整(如 0、1、2)。BCMath 或 GMP 擴展計算對數與冪。nowrap 或 防止單位換行。這個 formatSize() 函數簡潔、無依賴、覆蓋全單位範圍,是 PHP 專案中處理文件大小顯示的標準工具函數。