文件管理|目录操作|php遍历文件夹及其内部所有文件的方法详解

PHP遍历文件夹及其所有文件的完整指南：像老手一样管理目录

场景引入：当文件夹变成迷宫

想象一下这个场景：你刚接手一个老项目，发现资源文件夹里杂乱无章地堆放着数千个文件——图片、文档、缓存文件全都混在一起，就像走进了一个没有地图的迷宫，你需要快速统计所有文件类型、清理过期缓存或者批量重命名某些文件，但手动操作简直是一场噩梦，这时候,PHP的文件夹遍历功能就是你的瑞士军刀。

别担心，今天我们就来彻底掌握PHP遍历文件夹的技巧，让你能像图书馆管理员一样优雅地整理数字文件,以下是2025年最新验证过的方法大全。

基础篇：认识PHP目录遍历的核心函数

老当益壮的scandir()

$folderPath = '/path/to/your/folder';
if (is_dir($folderPath)) {
    $files = scandir($folderPath);
    foreach ($files as $file) {
        if ($file != '.' && $file != '..') {
            echo "发现文件: " . $file . "\n";
        }
    }
} else {
    echo "目录不存在或不可读";
}

特点：

• 最简单直接的目录列表获取方式
• 返回包含"."和".."的简单数组
• 适合轻量级操作和小型目录

功能更强大的DirectoryIterator

$dir = new DirectoryIterator('/path/to/folder');
foreach ($dir as $fileinfo) {
    if (!$fileinfo->isDot()) {
        echo $fileinfo->getFilename();
        if ($fileinfo->isDir()) {
            echo " (目录)";
        } else {
            echo " (文件, 大小: " . $fileinfo->getSize() . " 字节)";
        }
        echo "\n";
    }
}

优势：

• 面向对象风格，代码更易读
• 提供丰富的文件信息方法（大小、类型、修改时间等）
• 自动过滤系统目录(.和..)

进阶篇：递归遍历子文件夹

递归遍历的经典方案：RecursiveDirectoryIterator

$directory = '/path/to/your/main/folder';
$iterator = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS),
    RecursiveIteratorIterator::SELF_FIRST
);
foreach ($iterator as $file) {
    $indentation = str_repeat('    ', $iterator->getDepth());
    if ($file->isDir()) {
        echo $indentation . "📁 " . $file->getFilename() . "\n";
    } else {
        echo $indentation . "📄 " . $file->getFilename() . 
             " (". round($file->getSize()/1024, 2) . " KB)\n";
    }
}

专业技巧：

• SKIP_DOTS 参数自动跳过.和..
• SELF_FIRST 先处理当前目录再进入子目录
• getDepth() 方法获取当前遍历深度，用于缩进显示

带过滤条件的遍历：Glob模式匹配

// 查找所有扩展名为.jpg的文件（包括子目录）
$files = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($directory)
);
$jpgFiles = new RegexIterator($files, '/^.+\.jpg$/i', RecursiveRegexIterator::GET_MATCH);
foreach ($jpgFiles as $file) {
    echo "找到图片: " . $file[0] . "\n";
}

实用场景：

• 批量处理特定类型文件
• 按命名模式查找文件
• 结合正则表达式实现复杂匹配

实战篇：解决常见需求

案例1：计算文件夹总大小

function folderSize($path) {
    $totalSize = 0;
    $files = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($path)
    );
    foreach ($files as $file) {
        if ($file->isFile()) {
            $totalSize += $file->getSize();
        }
    }
    return $totalSize;
}
$sizeInMB = round(folderSize('/your/path') / (1024*1024), 2);
echo "文件夹总大小: {$sizeInMB} MB";

案例2：清理超过30天的临时文件

$tempFolder = '/path/to/temp';
$expiryDays = 30;
$now = time();
$files = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($tempFolder),
    RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($files as $file) {
    if ($file->isFile() && ($now - $file->getMTime()) > ($expiryDays * 86400)) {
        unlink($file->getRealPath());
        echo "已删除过期文件: " . $file->getFilename() . "\n";
    }
}

案例3：构建文件树数组

function buildFileTree($dir) {
    $tree = [];
    $files = scandir($dir);
    foreach ($files as $file) {
        if ($file != '.' && $file != '..') {
            $path = $dir . DIRECTORY_SEPARATOR . $file;
            if (is_dir($path)) {
                $tree[$file] = buildFileTree($path);
            } else {
                $tree[] = $file;
            }
        }
    }
    return $tree;
}
// 使用示例
$fileTree = buildFileTree('/your/directory');
print_r($fileTree);

性能优化与注意事项

1. 大目录处理技巧：

   • 对于超过10,000文件的目录，考虑分批处理
   • 使用SPL迭代器比传统递归函数更节省内存
   • 必要时添加set_time_limit(0)防止超时

2. 权限问题：

   try {
       $iterator = new RecursiveDirectoryIterator('/path', FilesystemIterator::SKIP_DOTS);
   } catch (UnexpectedValueException $e) {
       echo "无法访问目录: " . $e->getMessage();
   }

3. 符号链接处理：

   • 默认情况下迭代器不会跟随符号链接
   • 如需跟随，使用RecursiveDirectoryIterator::FOLLOW_SYMLINKS

4. 排序优化：

   

   $files = iterator_to_array($iterator);
   usort($files, function($a, $b) {
       return $a->getMTime() - $b->getMTime(); // 按修改时间排序
   });

2025年新特性：更简洁的遍历方式

PHP 8.3+ 引入了更简洁的目录遍历语法糖：

// 使用新的目录遍历语法（PHP 8.3+）
foreach (dir('/path') as $entry) {
    echo "{$entry->name} ({$entry->type})\n";
}

虽然语法更简单，但功能上相比DirectoryIterator有所缩减,适合简单场景。

选择适合你的方法

• 简单列表：scandir() + 简单循环
• 需要文件信息：DirectoryIterator
• 递归遍历：RecursiveDirectoryIterator + RecursiveIteratorIterator
• 模式匹配：GlobIterator 或 RegexIterator
• 最新语法：PHP 8.3+ 的dir()函数

处理文件系统操作时总是要添加适当的错误处理，文件路径在不同操作系统上表现可能不同，使用DIRECTORY_SEPARATOR常量可以让你的代码更具可移植性。

掌握了这些方法,你现在可以像专业开发者一样轻松驾驭任何复杂的文件夹结构了！