php fopen判断大小

admin 2026年03月02日 07:53 102 0

在PHP中，使用fopen()函数打开文件后，可通过filesize()或fstat()函数判断文件大小，filesize()直接传入文件路径，返回文件字节数；若已获取文件指针，则可用fstat()获取文件状态信息，size'键即为文件大小，两种方法均高效，前者适用于已知路径的场景，后者在文件已打开时更便捷，均需确保文件存在且可读。

PHP fopen与文件大小判断：实用技巧与代码示例

在PHP文件操作中，fopen()是最基础且最常用的函数之一，用于打开文件并返回文件指针资源，而"判断文件大小"则是文件处理中的常见需求——无论是限制上传文件体积、大文件分块读取，还是存储空间管理，都需要准确获取或判断文件大小，本文将结合fopen()函数，详细讲解PHP中文件大小判断的方法、技巧及实际应用场景。

fopen()函数基础：打开文件的前提

fopen()的作用是打开一个文件或URL，并返回一个文件指针，后续可通过该指针进行读取（fread）、写入（fwrite）等操作,其语法为：

resource fopen(string $filename, string $mode[, bool $use_include_path = false[, resource $context]])

$filename是要打开的文件路径，$mode是打开模式（如"r"只读、"w"写入、"a"追加等）。

关键点：fopen()本身并不直接返回文件大小，但它打开文件后，可通过其他函数（如fstat()、filesize()）获取文件信息。fopen()与"判断大小"的结合，通常体现在"打开文件后获取大小"或"根据大小决定是否打开文件"的场景中。

获取文件大小的常用方法

直接使用`filesize()`函数（无需打开文件）

filesize()是PHP中最简单的文件大小获取函数，返回文件大小（字节）,无需打开文件：

$filename = "example.txt";
if (file_exists($filename)) {
    $size = filesize($filename);
    echo "文件大小: " . $size . " 字节（约" . round($size/1024, 2) . " KB）";
} else {
    echo "文件不存在";
}

优点：

直接高效，适合仅需获取大小而不需要操作文件内容的场景
代码简洁，易于理解

注意事项：

如果文件不存在或无权限访问，filesize()会返回false，需提前用file_exists()检查
对于非常大的文件（超过2GB），在32位系统上可能返回不正确的结果
对于符号链接，filesize()返回的是链接目标文件的大小

通过`fopen()`+`fstat()`获取文件大小（需打开文件）

fstat()函数返回文件的状态信息（包括大小、修改时间、权限等），需要一个有效的文件指针作为参数，需先用fopen()打开文件，再调用fstat()：

$filename = "example.txt";
$handle = fopen($filename, "r"); // 以只读模式打开文件
if ($handle) {
    $fileStats = fstat($handle); // 获取文件状态信息
    $size = $fileStats['size'];   // 'size'键对应文件大小（字节）
    echo "文件大小: " . $size . " 字节";
    fclose($handle); // 关闭文件指针，释放资源
} else {
    echo "无法打开文件（可能不存在或无权限）";
}

适用场景：

当文件已通过fopen()打开，且需要同时获取文件大小和其他状态信息（如mtime修改时间）时，可避免重复打开文件
在处理网络流或特殊文件句柄时，fstat()可能是唯一可用的方法

注意事项：

fopen()失败时返回false，需提前判断
操作完成后务必用fclose()关闭文件指针，释放资源
相比filesize()，此方法需要额外打开文件，性能稍差

其他获取文件大小的方法

使用`stat()`函数（无需打开文件）

stat()函数与fstat()类似,但直接通过文件路径获取文件状态信息：

$filename = "example.txt";
if (file_exists($filename)) {
    $fileStats = stat($filename);
    $size = $fileStats['size'];
    echo "文件大小: " . $size . " 字节";
} else {
    echo "文件不存在";
}

使用`clearstatcache()`处理缓存问题

PHP会缓存文件状态信息以提高性能,但在某些情况下可能需要清除缓存：

$filename = "example.txt";
clearstatcache(); // 清除文件状态缓存
$size = filesize($filename);
echo "文件大小: " . $size . " 字节";

实际应用场景

文件上传大小限制

$maxFileSize = 5 * 1024 * 1024; // 5MB限制
$uploadedFile = $_FILES['userfile']['tmp_name'];
if (file_exists($uploadedFile)) {
    $fileSize = filesize($uploadedFile);
    if ($fileSize > $maxFileSize) {
        die("文件大小超过限制！最大允许5MB");
    }
    // 继续处理上传的文件
}

大文件分块读取

$filename = "large_file.txt";
$chunkSize = 1024 * 1024; // 1MB块大小
$handle = fopen($filename, "r");
if ($handle) {
    $fileSize = filesize($filename);
    $bytesRead = 0;
    while ($bytesRead < $fileSize) {
        $chunk = fread($handle, $chunkSize);
        // 处理当前块
        $bytesRead += strlen($chunk);
        // 显示进度
        $progress = ($bytesRead / $fileSize) * 100;
        echo "已处理: " . round($progress, 2) . "%\r";
    }
    fclose($handle);
}

存储空间管理

function checkDiskSpace($path, $minFreeSpaceMB = 100) {
    $freeSpace = disk_free_space($path);
    $minFreeSpaceBytes = $minFreeSpaceMB * 1024 * 1024;
    if ($freeSpace < $minFreeSpaceBytes) {
        $freeSpaceMB = round($freeSpace / (1024 * 1024), 2);
        throw new Exception("磁盘空间不足！剩余空间: {$freeSpaceMB}MB");
    }
    return true;
}
// 使用示例
try {
    checkDiskSpace('/var/www/uploads', 500);
    echo "磁盘空间充足，可以继续操作";
} catch (Exception $e) {
    echo $e->getMessage();
}

性能比较与最佳实践

方法	优点	缺点	适用场景
`filesize()`	简单直接，无需打开文件	无法获取其他文件信息	仅需文件大小的简单场景
`fstat()`	可同时获取多种文件信息	需要先打开文件	已打开文件或需要多种信息时
`stat()`	功能全面，无需打开文件	性能略低于`filesize()`	需要多种文件信息时