异常教程

PHP filesize() 函数（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 开发中，文件操作是一个常见的需求，而获取文件大小是其中的基础操作之一。PHP filesize() 函数作为 PHP 内置的实用工具，能够帮助开发者快速获取指定文件的字节大小。无论是验证上传文件的大小限制、统计日志文件的体积，还是优化存储空间，这一函数都扮演着关键角色。本文将从函数的基本用法、核心特性、常见问题及实战案例等角度，深入解析 PHP filesize() 函数的使用方法和注意事项，帮助开发者高效掌握这一工具。

函数基础：语法与核心参数

基础语法

PHP filesize() 函数的语法非常简洁，其基本形式如下：

filesize( string $filename ) : int|false
  • 参数说明：
    • $filename：需要检测的文件路径，可以是相对路径或绝对路径。
  • 返回值：
    • 成功时返回文件的字节数（以整数形式），失败时返回 false（例如文件不存在或权限不足）。

使用示例

以下是一个简单的使用案例，演示如何获取 example.txt 文件的大小：

<?php  
$file_path = "example.txt";  
$file_size = filesize($file_path);  

if ($file_size !== false) {  
    echo "文件大小为：" . $file_size . " 字节";  
} else {  
    echo "无法获取文件大小，可能文件不存在或权限不足。";  
}  
?>

文件路径的注意事项

  • 相对路径与绝对路径：
    相对路径是相对于当前 PHP 脚本的执行目录，而绝对路径需从根目录开始（例如 /var/www/html/example.txt）。建议使用绝对路径以避免路径错误。
  • 跨平台兼容性：
    在 Windows 系统中，路径分隔符为反斜杠 \，但在 PHP 中需转义为 \\ 或使用正斜杠 /（PHP 对正斜杠有较好的兼容性）。

进阶用法：单位转换与异常处理

单位转换：将字节转换为 KB/MB/GB

获取到的文件大小以字节为单位，对于用户而言，更直观的可能是 KB、MB 或 GB。可以通过以下代码实现单位转换：

function format_size($bytes) {  
    $units = ['B', 'KB', 'MB', 'GB', 'TB'];  
    $power = $bytes > 0 ? floor(log($bytes, 1024)) : 0;  
    return round($bytes / pow(1024, $power), 2) . ' ' . $units[$power];  
}  

$file_size = filesize("example.txt");  
echo format_size($file_size); // 输出类似 "2.5 MB"

单位转换的比喻

可以将这一过程想象为“单位换算尺子”：

  • 字节是“最小刻度”，当数值超过 1024 时，就“升级”到 KB，以此类推。

错误处理：优雅应对异常情况

filesize() 在以下情况下会返回 false：

  1. 文件不存在；
  2. 当前用户权限不足（例如无读取权限）；
  3. 文件路径无效（例如包含非法字符）。

错误处理示例

if (!file_exists($file_path)) {  
    echo "文件不存在！";  
} else if (!is_readable($file_path)) {  
    echo "无权限读取文件！";  
} else {  
    $size = filesize($file_path);  
    // 继续处理  
}

权限问题的解决方案

  • 检查文件权限：使用 chmod 命令或文件管理工具调整文件权限（例如设置为 644）；
  • 路径验证：确保路径拼接正确，避免拼接后的路径指向非预期位置。

常见问题与解决方案

问题 1：返回值为 false 的原因分析

当 filesize() 返回 false 时，需通过以下步骤排查：

  1. 检查文件是否存在：使用 file_exists() 函数验证；
  2. 验证路径有效性：确保路径拼接正确，无拼写错误；
  3. 权限检查：确认 PHP 进程有权限访问该文件。

问题 2：处理大文件时的精度丢失

在 32 位系统中，若文件大小超过 2GB（即 2^31 - 1 字节），filesize() 的返回值可能因整数溢出而失真。此时可改用 stat() 函数获取更精确的文件大小：

$stat = stat($file_path);  
$file_size = $stat['size']; // 64位系统下支持大文件

问题 3：与符号链接（Symlink）的交互

若文件路径为符号链接，filesize() 默认返回的是符号链接指向的文件大小。若需获取符号链接本身的大小，需先通过 readlink() 获取原始路径。

实战案例：文件大小验证与统计

案例 1：上传文件大小限制

在用户上传文件时，常需验证文件是否符合大小要求。结合 filesize() 可实现如下逻辑：

$max_size = 5 * 1024 * 1024; // 5MB  
if (filesize($_FILES['userfile']['tmp_name']) > $max_size) {  
    die("文件过大！");  
}

案例 2：统计目录下所有文件的总大小

function total_directory_size($dir_path) {  
    $total = 0;  
    $files = scandir($dir_path);  
    foreach ($files as $file) {  
        if ($file == '.' || $file == '..') {  
            continue;  
        }  
        $current_path = $dir_path . '/' . $file;  
        if (is_file($current_path)) {  
            $total += filesize($current_path);  
        }  
    }  
    return $total;  
}  

echo "总大小：" . format_size(total_directory_size("/var/logs"));

最佳实践与性能优化

实践建议

  1. 避免重复调用：若需多次使用同一文件的大小，建议先缓存结果；
  2. 结合其他函数：与 file_exists()、is_readable() 配合使用，确保输入合法性；
  3. 处理大文件时切换方法：在 32 位系统或处理超大文件时，改用 stat() 函数。

性能优化技巧

  • 减少磁盘 I/O：若需同时获取文件信息，优先使用 stat()，因其可一次获取文件大小、修改时间等多参数；
  • 缓存机制：在高频操作场景中，可将文件大小缓存至内存或数据库。

结论

PHP filesize() 函数是一个简单却强大的工具，能够快速获取文件的字节大小。通过结合单位转换、错误处理和路径验证，开发者可以将其灵活应用于文件上传校验、日志分析、存储监控等场景。在实际开发中，需注意系统位数、文件权限和路径问题，以确保代码的健壮性和兼容性。掌握这一函数的底层逻辑与最佳实践，将显著提升 PHP 开发效率，为构建更可靠的应用程序奠定基础。

关键知识点总结

场景解决方案
文件不存在或路径错误使用 file_exists() 和 is_readable() 验证路径和权限
大文件处理（>2GB）切换到 stat() 函数以避免整数溢出
单位转换自定义 format_size() 函数实现字节到 KB/MB/GB 的转换
性能优化缓存文件大小或使用 stat() 获取多参数以减少磁盘 I/O

通过本文的讲解，开发者可以系统地掌握 PHP filesize() 函数的使用方法，并结合实际案例理解其在不同场景下的应用价值。无论是初学者还是中级开发者，都能从中获得实用的技术洞见，进一步提升 PHP 文件操作的技能水平。

最新发布

查看更多文章