萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 文件大小格式化顯示函數(支援 B~YB)

在 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)十進制近似
ByteB1024^01 B
KibibyteKiB / KB1024^11,024 B
MebibyteMiB / MB1024^21,048,576 B
GibibyteGiB / GB1024^31,073,741,824 B
TebibyteTiB / TB1024^41.0995e12 B
PebibytePiB / PB1024^51.1259e15 B
ExbibyteEiB / EB1024^61.1529e18 B
ZebibyteZiB / ZB1024^71.1806e21 B
YobibyteYiB / YB1024^81.2089e24 B

註:IEC 標準建議 KiB/MiB/GiB 表示 1024 進制,KB/MB/GB 表示 1000 進制。本函數按 1024 進制計算,單位沿用常見 KB/MB/GB 寫法。

進階:支援 1000 進制 (SI) 模式

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)。
  • 極大數值(> PHP_INT_MAX)需用 BCMath 或 GMP 擴展計算對數與冪。
  • 前端展示時建議加 nowrap 或   防止單位換行。

這個 formatSize() 函數簡潔、無依賴、覆蓋全單位範圍,是 PHP 專案中處理文件大小顯示的標準工具函數。

copyright © 萬盛學電腦網 all rights reserved