將位元組數值轉為 KB、MB、GB 等易讀單位是常見需求。本文提供健壯、支援大數值、可自訂精度的函式。
<?php
/**
* 將位元組轉為人類可讀格式
*
* @param int|float $bytes 位元組數
* @param int $precision 小數位數
* @param array $units 單位陣列 (可自訂二進制/十進制)
* @return string
*/
function humanFileSize($bytes, $precision = 2, $units = null)
{
$bytes = max((float)$bytes, 0);
$units = $units ?? ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
if ($bytes < 1024) {
return $bytes . ' ' . $units[0];
}
$pow = floor(log($bytes, 1024));
$pow = min($pow, count($units) - 1);
$value = $bytes / (1024 ** $pow);
return round($value, $precision) . ' ' . $units[$pow];
}
// 使用範例
echo humanFileSize(1023); // 1023 B
echo humanFileSize(1024); // 1 KiB
echo humanFileSize(1536); // 1.5 KiB
echo humanFileSize(1048576); // 1 MiB
echo humanFileSize(1234567890); // 1.15 GiB
echo humanFileSize(1099511627776); // 1 TiB
?>
function humanFileSizeSI($bytes, $precision = 2)
{
$units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
$bytes = max((float)$bytes, 0);
if ($bytes < 1000) return $bytes . ' ' . $units[0];
$pow = floor(log($bytes, 1000));
$pow = min($pow, count($units) - 1);
$value = $bytes / (1000 ** $pow);
return round($value, $precision) . ' ' . $units[$pow];
}
function formatBytes($bytes, $options = [])
{
$defaults = [
'precision' => 2,
'binary' => true, // true=1024 (KiB), false=1000 (KB)
'space' => true, // 數值與單位間加空格
'locale' => null, // 如 'zh_TW' 使用當地數字格式
];
$opt = array_merge($defaults, $options);
$bytes = (float)$bytes;
$sign = $bytes < 0 ? '-' : '';
$bytes = abs($bytes);
$base = $opt['binary'] ? 1024 : 1000;
$units = $opt['binary']
? ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB']
: ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
if ($bytes < $base) {
return $sign . $bytes . ($opt['space'] ? ' ' : '') . $units[0];
}
$pow = floor(log($bytes, $base));
$pow = min($pow, count($units) - 1);
$value = $bytes / ($base ** $pow);
$formatted = round($value, $opt['precision']);
if ($opt['locale']) {
$formatted = number_format($formatted, $opt['precision'], '.', ',');
}
return $sign . $formatted . ($opt['space'] ? ' ' : '') . $units[$pow];
}
// 使用
echo formatBytes(1500); // 1.46 KiB
echo formatBytes(1500, ['binary' => false]); // 1.5 KB
echo formatBytes(-1048576); // -1 MiB
echo formatBytes(1234567, ['locale' => 'zh_TW']); // 1,177.38 MiB
?>
| 函式 | 100萬次呼叫耗時 | 備註 |
|---|---|---|
| humanFileSize (log 版) | ~0.18 秒 | 通用、支援大數 |
| 迴圈除法版 | ~0.12 秒 | 較快,但需迴圈 |
| sprintf + 陣列查找 | ~0.15 秒 | 平衡 |
差異微小,一般應用無感。推薦使用 log 版本程式碼最簡潔。
humanFileSize() 為最通用實作,支援二進制單位 (KiB/MiB) 符合 IEC 標準。若需相容硬碟廠商標示習慣,使用 SI 版本 (KB/MB)。