filesize返回字节数，不能直接显示“XX MB”因单位换算需明确1024或1000进制；使用前须检查file_exists、is_readable、is_file；换算时应处理0字节、保留1位小数、规范单位大小写。
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，但容易和文件读取失败混淆）
示例：
立即学习“PHP免费学习笔记（深入）”；
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 < count($units) - 1) {
$size /= 1024.0;
$i++;
}
return round($size, 1) . ' ' . $units[$i];
}常见报错和绕过方式
最常卡在 Warning: filesize(): stat failed，本质是路径不对或权限不够，不是函数本身问题。
-
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。
