在PHP中获取文件大小是一个常见的需求，无论是用于文件上传、存储管理还是数据统计，准确获取文件大小都是基础操作，PHP提供了多种内置函数和方法来实现这一功能，本文将详细介绍这些方法的使用场景、代码示例及注意事项,帮助开发者全面掌握文件大小获取的技巧。
最基础的方法是使用filesize()函数，该函数专门用于获取指定文件的大小（以字节为单位），其语法简单，只需传入文件路径作为参数即可。$size = filesize('example.txt');将返回文件example.txt的大小，需要注意的是，如果文件不存在或路径无效，filesize()会返回false，因此在实际应用中应结合file_exists()函数进行判断，避免因文件不存在导致的错误。filesize()返回的是字节数，如果需要更友好的单位（如KB、MB），可以手动进行转换,例如通过除以1024的幂次方来实现。
对于需要更高性能或更复杂场景的情况，可以使用stat()函数。stat()函数返回一个包含文件详细信息的数组，其中size键即为文件大小。$fileInfo = stat('example.txt'); $size = $fileInfo['size'];，与filesize()相比，stat()能提供更多元数据，如最后修改时间、 inode号等，适用于需要同时获取多个文件属性的场景，但需要注意的是，stat()会获取文件的完整状态信息，性能略低于filesize()，因此在仅需文件大小时，优先推荐使用filesize()。
在处理远程文件时，由于filesize()和stat()仅支持本地文件路径，需要借助其他方法，使用fopen()打开远程URL并获取文件头信息，通过解析Content-Length字段来获取文件大小，代码示例如下：$headers = get_headers('http://example.com/remote_file.zip', 1); $size = $headers['Content-Length'];，这里get_headers()函数获取HTTP响应头，Content-Length字段通常包含文件大小，需要注意的是，远程文件可能未提供Content-Length，或者服务器返回压缩后的内容，此时该方法可能不准确，远程操作需要确保allow_url_fopen选项已启用，并考虑超时设置,避免长时间阻塞。
在面向对象编程中，可以使用SplFileInfo类，该类是PHP标准库（SPL）的一部分，提供了面向文件的操作接口，通过new SplFileInfo('example.txt')创建对象后，调用getSize()方法即可获取文件大小。$file = new SplFileInfo('example.txt'); $size = $file->getSize();。SplFileInfo的优势在于支持链式操作，并能与其他SPL组件（如FilesystemIterator）结合使用，适合复杂文件遍历和统计场景。SplFileInfo还提供了getMTime()、getATime()等方法,方便获取文件的其他属性。
以下是不同方法获取文件大小的性能对比（以毫秒为单位）：
| 方法 | 适用场景 | 性能（毫秒） | 返回值类型 | 是否支持远程文件 |
|---|---|---|---|---|
| filesize() | 本地文件大小 | 01-0.05 | int/bool | 否 |
| stat() | 本地文件元数据 | 05-0.1 | array | 否 |
| get_headers() | 远程文件大小 | 100-500 | string/int | 是 |
| SplFileInfo::getSize() | 面向对象操作 | 1-0.2 | int | 否 |
需要注意的是，文件大小获取的结果可能因操作系统或文件系统而异，某些文件系统可能不支持大文件（超过2GB），此时filesize()可能返回负数，需要结合sprintf('%u', filesize($file))处理，在Windows系统中，文件路径使用反斜杠（\），而Linux/macOS使用正斜杠（），建议使用DIRECTORY_SEPARATOR常量确保跨平台兼容性。
在文件上传场景中，获取文件大小通常用于验证上传限制，通过$_FILES['file']['size']可直接获取上传文件的大小，并与预设的最大值比较，但需注意，$_FILES中的大小是客户端提交的值，可能被篡改，因此服务器端仍需重新验证文件实际大小,确保安全性。
对于超大文件（如超过4GB），在32位系统上可能存在限制，建议使用64位PHP环境或分块读取文件的方式估算大小，通过读取文件末尾的块信息来计算大小，但这种方法较为复杂，通常直接使用filesize()即可满足大多数需求。
相关问答FAQs
Q1: 为什么filesize()函数返回false？如何处理？
A1: filesize()返回false通常是因为文件不存在、路径错误或权限不足，解决方案：使用file_exists()检查文件是否存在，is_readable()验证可读权限，并结合错误处理（如try-catch）捕获异常。
if (file_exists('example.txt') && is_readable('example.txt')) {
$size = filesize('example.txt');
} else {
die("文件不可读或不存在");
}
Q2: 如何将文件大小从字节转换为KB/MB等单位？
A2: 可以通过除以1024的幂次方并格式化输出来实现，以下是转换函数示例：
function formatFileSize($bytes) {
$units = ['B', 'KB', 'MB', 'GB', 'TB'];
$bytes = max($bytes, 0);
$pow = floor(($bytes ? log($bytes) : 0) / log(1024));
$pow = min($pow, count($units) - 1);
$bytes /= pow(1024, $pow);
return round($bytes, 2) . ' ' . $units[$pow];
}
echo formatFileSize(1048576); // 输出: 1 MB 
