PHP中获取文件大小需使用filesize()函数，返回字节数，结合formatBytes函数可转换为KB、MB等易读单位。该函数通过log计算数量级，支持精度控制与单位扩展，适用于本地文件但不支持远程URL。需注意权限、文件存在性及32位系统对大文件的限制。实际应用中常用于上传校验，需前后端协同判断，结合$_FILES['size']与php.ini配置，确保安全性与用户体验。
PHP中获取文件大小主要通过内置的
filesize()函数，它返回的是文件字节数。要格式化显示，通常需要结合数学运算和条件判断，将其转换为更易读的单位，比如KB、MB或GB。
解决方案
要获取文件大小并进行格式化显示，我们通常会先用
filesize()函数拿到原始字节数，然后编写一个辅助函数来处理单位转换。这个过程其实挺直接的，但有些细节值得琢磨。
首先，
filesize()函数接受一个文件路径作为参数，并返回该文件的大小，单位是字节（bytes）。如果文件不存在或者无法读取，它会返回
false。
<?php
$filePath = '/path/to/your/file.txt'; // 替换为你的文件路径
if (file_exists($filePath)) {
$bytes = filesize($filePath);
echo "文件原始大小: " . $bytes . " 字节\n";
// 接下来是格式化显示的核心逻辑
function formatBytes($bytes, $precision = 2) {
$units = array('B', 'KB', 'MB', 'GB', 'TB');
$bytes = max($bytes, 0);
$pow = floor(($bytes ? log($bytes) : 0) / log(1024));
$pow = min($pow, count($units) - 1);
// 使用 round 而不是 number_format，可以更好地控制精度
return round($bytes / pow(1024, $pow), $precision) . ' ' . $units[$pow];
}
echo "格式化后大小: " . formatBytes($bytes) . "\n";
echo "更高精度格式化: " . formatBytes($bytes, 3) . "\n";
} else {
echo "文件不存在或无法访问。\n";
}
?>这个
formatBytes函数的核心思路是，通过计算字节数对1024的对数，来确定它应该属于哪个数量级（KB、MB等），然后进行除法运算并保留指定精度。这比简单的
if/else if链条要灵活一些，也更优雅，尤其当未来需要支持更大单位时，只需扩展
$units数组即可。
立即学习“PHP免费学习笔记（深入）”；
PHP filesize()
函数的潜在陷阱与跨平台兼容性
在使用
filesize()时，我遇到过一些不是那么显而易见的问题，这玩意儿看似简单，实则有些坑。最常见的就是权限问题，如果PHP脚本运行的用户没有读取文件的权限，
filesize()会直接返回
false，而不是抛出一个明确的错误，这需要你用
file_exists()或者
is_readable()先进行判断，否则很容易在生产环境踩坑。
另一个值得注意的点是，
filesize()无法直接获取远程文件（如HTTP或FTP URL）的大小。如果你想获取一个通过URL访问的远程文件大小，你需要采用不同的策略，比如使用
get_headers()函数来获取HTTP响应头中的
Content-Length字段，或者更复杂的，通过
cURL来实现。这其实是两个不同的场景，
filesize()专注于本地文件系统。
在跨平台兼容性方面，
filesize()通常表现良好，但在某些老旧的32位系统上，如果文件大小超过2GB（2^31 - 1 字节），它可能会返回不正确的值，因为PHP的整型限制。不过，现在大多数服务器都是64位环境，这个问题已经很少见了。但如果你的应用需要部署在各种奇奇怪怪的环境中，了解这个潜在的限制还是有必要的。遇到这种情况，你可能需要考虑使用
stat()函数，它能提供更详细的文件信息，并且在某些情况下可能对大文件有更好的处理。
文件大小格式化显示的最佳实践与代码优化思路
文件大小的格式化显示，不仅仅是把字节数转换成KB、MB那么简单，它还涉及到用户体验和代码的可维护性。我个人觉得，上面提供的
formatBytes函数已经是一个不错的起点，但我们还可以从几个方面去思考优化。
首先是精度问题。我们给
round()设定了默认的
precision = 2，这对于大多数情况来说是足够的，但有时候，比如文件特别小，只有几十个字节，显示成 "0.05 KB" 可能不如直接显示 "50 B" 来得直观。所以，在某些特定场景下，可以考虑对极小值进行特殊处理，或者动态调整精度。例如，如果转换后小于1，可以考虑直接显示为字节。
其次，关于性能。尽管文件大小获取和格式化通常不是性能瓶颈，但如果在一个循环中对成千上万个文件进行操作，那么即使是微小的优化也可能累积起来。上面我们使用了
log()和
pow()，这些数学函数在PHP中效率很高。避免在循环中重复定义函数或不必要的计算，确保
$units数组是静态的或全局的，这些都是常规的优化思路。
最后，代码的可读性和可重用性。将格式化逻辑封装成一个独立的函数是最佳实践，这样可以在项目中的任何地方方便地调用，保持代码的DRY（Don't Repeat Yourself）原则。同时，给函数参数设置合理的默认值，比如
precision = 2，也能让函数更易用。
实际项目中文件大小校验与上传限制的考量
在实际的Web开发中，文件大小的获取和格式化，最常见的应用场景就是用户上传文件。这里面涉及到的校验和限制，远比想象的要复杂一些，因为你需要同时在客户端和服务器端进行双重验证。
客户端（前端）的校验主要是为了提升用户体验。在用户选择文件后，通过JavaScript立即获取文件大小并进行初步判断，如果文件过大，可以直接提示用户，避免不必要的上传，减少服务器压力。但请记住，前端校验永远不可信，它很容易被绕过。
服务器端（后端）的校验才是重中之重。当用户提交文件后，PHP会通过
$_FILES['file']['size']数组提供文件大小。我们需要在这里对文件大小进行严格的检查，确保它不超过我们设定的上限。这个上限通常会受到
php.ini配置的两个参数影响：
upload_max_filesize（单个文件最大上传大小）和
post_max_size（POST请求总大小）。如果用户上传的文件超过了这些限制，PHP甚至可能在脚本执行前就拒绝接收文件，导致
$_FILES数组为空或者不完整。
因此，在处理文件上传时，一个健壮的流程应该是：
- 前端预检： 使用JavaScript快速判断文件大小，提供即时反馈。
-
后端校验：
- 检查
$_FILES['file']['error']
是否为UPLOAD_ERR_INI_SIZE
或UPLOAD_ERR_FORM_SIZE
，这表明文件大小超过了php.ini
或HTML表单设定的限制。 - 如果
$_FILES['file']['size']
有效，再用自定义的业务逻辑进行判断，比如你可能允许上传10MB的图片，但php.ini
设置的是20MB。 - 结合
formatBytes
函数，可以给用户提供更友好的错误提示，比如“文件大小不能超过5MB，您上传的文件是12.5MB。”
- 检查
除了上传，文件大小在磁盘空间管理、日志记录、审计和数据备份等场景中也扮演着重要角色。例如，定期扫描某个目录，获取所有文件大小并计算总和，可以帮助我们监控磁盘使用情况，及时发现异常增长的文件或目录。
