PHP获取文件大小方法详解

本文深入解析了PHP中filesize函数的正确使用方法，强调其仅返回原始字节数、绝不直接等同于“KB/MB”，并系统梳理了调用前必须完成的三项安全检查（file_exists、is_readable、is_file）以避免静默失败或警告错误；同时提供了兼顾兼容性与可读性的单位换算方案，涵盖0字节处理、1024进制规范、小数精度控制及大小写统一等细节，并直击开发中高频踩坑点——如路径错误、权限不足、相对路径歧义、Windows长路径限制及32位环境下大文件截断问题，帮助开发者避开线上故障雷区。

filesize 返回的是字节数，不是 KB/MB，直接用会出错。

filesize 函数返回什么、为什么不能直接显示“XX MB”

它只返回一个整数，单位是字节。比如 filesize('log.txt') 返回 10240，不代表 10240 字节就是“10 KB”——因为有人按 1000 进制算（1 KB = 1000 B），PHP 默认按 1024 进制（1 KiB = 1024 B），但 filesize 自己不处理换算。

• 直接 echo filesize($path) 会输出纯数字，前端看不懂
• 不做单位换算就除以 1024，遇到空文件（filesize 返回 0）或不存在的文件（返回 false）会报 Warning
• 没检查文件是否存在或是否可读，filesize 就会静默失败或触发 Warning: filesize(): stat failed

调用前必须做的三件事

别跳过检查，否则线上突然报错没人知道为什么。

• 用 file_exists($path) 确认文件存在
• 用 is_readable($path) 确认有读权限（尤其在 Linux 下，web 用户可能无权读某些目录）
• 用 is_file($path) 排除目录误判（filesize 对目录也返回 false，但容易和文件读取失败混淆）

示例：

if (file_exists($path) && is_readable($path) && is_file($path)) {
    $bytes = filesize($path);
} else {
    $bytes = 0; // 或抛异常、记录日志
}

安全换算成人类可读大小（KB/MB/GB）

别手写除法链，PHP 8.1+ 有 format_bytes，但太新；通用做法是自己写个简单函数，注意浮点精度和单位后缀大小写。

• 用 1024 做基数，不是 1000（除非业务明确要求 SI 单位）
• 结果保留 1 位小数，round($size, 1) 比 number_format 更轻量
• 单位用 'B' / 'KB' / 'MB' / 'GB'，别写成 'Kb' 或 'mb'（大小写混乱易引发前端解析错误）
• 避免对 0 字节做除法：先判断 $bytes === 0，直接返回 '0 B'

简版参考：

function formatFileSize(int $bytes): string {
    if ($bytes === 0) return '0 B';
    $units = ['B', 'KB', 'MB', 'GB'];
    $i = 0;
    $size = $bytes;
    while ($size >= 1024 && $i <h3>常见报错和绕过方式</h3><p>最常卡在 <code>Warning: filesize(): stat failed</code>，本质是路径不对或权限不够，不是函数本身问题。</p>

• filesize('/tmp/upload/xxx.jpg') 报错？先 var_dump(file_exists('/tmp/upload/xxx.jpg'))，大概率路径拼错了或文件被删了
• 用相对路径（如 './data/file.zip'）时，当前工作目录（getcwd()）可能不是你认为的那个目录——统一用 __DIR__ . '/data/file.zip'
• Windows 下长路径（>260 字符）可能失败，加 \\?\ 前缀也没用，得用 realpath() 先规范化
• 大文件（>2GB）在 32 位 PHP 上会返回负数或截断，filesize 本身不支持，得换 stream_stat + ftell 或改用 exec('stat -c %s '.$path)（仅限 Linux）

路径和权限问题永远比函数用法更难 debug。

本篇关于《PHP获取文件大小方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！