PHP文件大小格式化函数合集

作为一个Web开发人员，我们通常需要处理各种文件，比如上传、下载、访问等等。而在处理文件的时候，我们常常需要显示文件的大小，尤其是当文件的大小超过1MB时，为了更好的用户体验，我们需要将文件大小进行友好的格式化，比如将“1234567”格式化成“1.18 MB”。而PHP恰恰提供了一些非常方便的文件大小格式化函数，我们在开发过程中应该充分利用这些函数。

一、文件大小格式化函数

在PHP中，常用的文件大小格式化函数有filesize()和number_format()两个函数，这两个函数可以结合使用，实现友好的文件大小格式化。下面分别介绍这两个函数的使用情况。

1. filesize()函数

该函数可以获取文件的大小，它的语法如下：

int filesize ( string $filename )

函数接收一个字符串参数，即文件名，返回该文件的大小。返回值的单位是字节（Byte），所以我们需要对返回值进行进一步的格式化。下面是一个示例：

$size = filesize('test.mp4');
echo $size;  //输出：952877574

上述代码将会输出该文件的大小，单位为字节（Byte）。

2. number_format()函数

该函数可以将数字进行格式化，它的语法如下：

string number_format ( float $number [, int $decimals = 0 ] )

该函数接收两个参数，第一个参数是数字，第二个参数是小数点后的位数，默认值为0。该函数的返回值是一个字符串，是经过格式化后的数字。下面是一个示例：

$num = number_format(1234567.89);
echo $num;  //输出：1,234,567

上述代码会将数字1234567.89格式化为1,234,567。

3. 文件大小格式化

结合上述两个函数，我们可以将文件大小进行友好的格式化。具体实现方法如下：

/**
 * 格式化文件大小
 *
 * @param string $file_path 文件路径
 * @return string
 */
function format_file_size($file_path) {
    $size = filesize($file_path);
    $units = array('B', 'KB', 'MB', 'GB', 'TB', 'PB'); //定义文件大小单位
    $index = 0; //初始化单位为Byte
    while ($size > 1024) {
        $size /= 1024;
        $index++;
    }
    return number_format($size, 2) . ' ' . $units[$index];
}

上述代码定义了一个format_file_size()函数，实现了文件大小友好格式化的功能。该函数接收一个参数$file_path，即文件路径，返回一个格式化后的字符串。该函数首先使用filesize()函数获取文件大小，然后循环计算出文件大小所在的单位（字节、KB、MB、GB等等），最后使用number_format()函数进行格式化，输出友好的文件大小字符串。下面是一个示例：

$file_size = format_file_size('test.mp4');
echo $file_size;  //输出：908.13 MB

上述代码将会输出文件大小为908.13 MB。

二、示例说明

下面我们通过两个示例说明如何使用上述文件大小格式化函数。

1. 文件大小列排序

在一个包含多个文件的文件夹中，我们需要可以对文件进行按大小排序。下面是一个示例：

$folder_path = '/path/to/folder'; //文件夹路径
$files = scandir($folder_path); //获取文件夹中的文件列表
$file_sizes = array(); //用于存储文件大小的数组
foreach ($files as $file) {
    if ($file != '.' && $file != '..') { //忽略特殊目录
        $file_path = $folder_path . '/' . $file; //获取文件绝对路径
        $size = filesize($file_path); //获取文件大小
        $file_sizes[$file] = $size; //将文件名和文件大小存储在数组中
    }
}
arsort($file_sizes); //按照文件大小排序，从大到小
foreach ($file_sizes as $file => $size) {
    echo $file . ' (' . format_file_size($folder_path . '/' . $file) . ')' . "\n"; //输出文件名和文件大小
}

上述代码首先使用scandir()函数获取文件夹中的文件列表，遍历每个文件，利用filesize()函数获取文件大小，将文件名和文件大小存储在数组中，然后对数组进行排序，最后使用format_file_size()函数输出文件名和文件大小。

2. 表格输出文件大小

在一个Web页面中，我们需要以表格形式输出文件的列表，其中需要友好的文件大小显示。下面是一个示例：

<table>
    <thead>
        <tr>
            <th>文件名</th>
            <th>文件大小</th>
        </tr>
    </thead>
    <tbody>
        <?php foreach ($files as $file) { ?>
        <?php if ($file != '.' && $file != '..') { //忽略特殊目录 ?>
        <tr>
            <td><?php echo $file; ?></td>
            <td><?php echo format_file_size($folder_path . '/' . $file); ?></td>
        </tr>
        <?php } ?>
        <?php } ?>
    </tbody>
</table>

上述代码中，我们使用了一个HTML表格，遍历$files数组中的每个文件，使用format_file_size()函数输出文件大小。在这个示例中，我们把文件大小格式化成了友好的KB、MB、GB等单位，更加符合人的阅读习惯，增加了Web页面的美观性。