PHP格式化文件大小显示的实现方法
在开发文件上传、存储管理等相关功能时，我们经常需要将文件的大小（通常以字节为单位存储）转换成用户容易阅读的形式，比如将 1024 字节显示为 1KB，将 1048576 字节显示为 1MB。下面我们就来实现一个通用的PHP函数来完成这个格式化操作。
实现思路
文件大小格式化的核心逻辑是：首先定义好常用的文件大小单位，从最小的字节（B）开始，到KB、MB、GB、TB等；然后不断用当前文件大小除以1024，直到结果小于1024或者已经遍历完所有单位；最后保留合适的小数位数，拼接单位返回即可。
完整代码示例
下面是一个可以直接使用的格式化函数，支持自定义小数位数，默认保留2位小数：
/**
* 格式化文件大小显示
* @param int $bytes 文件大小，单位字节
* @param int $decimals 保留的小数位数，默认2位
* @return string 格式化后的文件大小字符串
*/
function formatFileSize($bytes, $decimals = 2) {
// 定义文件大小单位，从字节开始
$units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
// 如果文件大小小于等于0，直接返回0B
if ($bytes <= 0) {
return '0 B';
}
// 计算单位索引，每1024进一位
$unitIndex = floor(log($bytes, 1024));
// 防止索引超出单位数组范围
if ($unitIndex >= count($units)) {
$unitIndex = count($units) - 1;
}
// 计算当前单位下的数值，保留指定小数位数
$size = round($bytes / pow(1024, $unitIndex), $decimals);
// 拼接数值和单位返回
return $size . ' ' . $units[$unitIndex];
}
// 测试示例
echo formatFileSize(0); // 输出：0 B
echo "<br/>";
echo formatFileSize(1024); // 输出：1.00 KB
echo "<br/>";
echo formatFileSize(1048576); // 输出：1.00 MB
echo "<br/>";
echo formatFileSize(1073741824); // 输出：1.00 GB
echo "<br/>";
echo formatFileSize(12345678); // 输出：11.77 MB
echo "<br/>";
echo formatFileSize(12345678, 0); // 输出：12 MB代码说明
上面的formatFileSize函数首先处理了边界情况：如果传入的文件大小小于等于0，直接返回0 B，避免后续计算出错。接着通过log($bytes, 1024)计算需要进位的次数，也就是对应的单位索引，同时做了索引越界的保护，防止文件大小过大超出预设的单位范围。
然后使用pow(1024, $unitIndex)计算当前单位对应的字节数，用原始字节数除以这个值得到当前单位下的数值，再通过round函数保留指定的小数位数。最后把数值和对应的单位拼接起来返回即可。
测试部分展示了不同大小的文件经过格式化后的输出结果，你可以根据自己的需求调整$decimals参数来控制小数位数，让显示效果更符合要求。
注意事项
- 传入的
$bytes参数需要是整型的字节数，如果是字符串形式的数值，建议先通过intval转换后再传入函数。 - 如果业务场景中需要支持更大的单位（比如EB、ZB等），只需要在
$units数组中添加对应的单位即可，函数会自动适配。 - 如果需要去掉数值后面的尾随0（比如1.00 KB改成1 KB），可以额外添加字符串处理逻辑，比如使用
rtrim(rtrim($size, '0'), '.')处理数值部分。