PHP 递归遍历目录获取所有文件（含子目录）：scandir + 生成器内存优化、SPL 迭代器对比

三种实现方案对比

方案一：scandir 递归（教学/小目录）

<?php
function getAllFiles(string $dir): array
{
    $files = [];
    $entries = scandir($dir);
    foreach ($entries as $entry) {
        if ($entry === '.' || $entry === '..') continue;
        $path = $dir . DIRECTORY_SEPARATOR . $entry;
        if (is_dir($path)) {
            $files = array_merge($files, getAllFiles($path));
        } else {
            $files[] = $path;
        }
    }
    return $files;
}

// 使用
$list = getAllFiles(__DIR__ . '/storage');
print_r($list);

缺点：array_merge 反复复制数组，大目录下内存峰值 = 所有路径字符串总和 + 索引数组开销，易触发 memory_limit。

方案二：Generator 生成器（推荐大目录）

<?php
function iterFiles(string $dir): \Generator
{
    $entries = scandir($dir);
    foreach ($entries as $entry) {
        if ($entry === '.' || $entry === '..') continue;
        $path = $dir . DIRECTORY_SEPARATOR . $entry;
        if (is_dir($path)) {
            yield from iterFiles($path); // PHP 7+ 委托生成器
        } else {
            yield $path;
        }
    }
}

// 使用：逐个处理，内存恒定
foreach (iterFiles('/var/www/uploads') as $file) {
    // 处理单文件：上传、压缩、扫描病毒...
    processFile($file);
}

// 若必须收集数组（不推荐大目录）
$all = iterator_to_array(iterFiles($dir), false);

生成器实现「惰性求值」，yield from 无缝委托子生成器，代码简洁且内存友好。

方案三：SPL RecursiveDirectoryIterator（生产首选）

<?php
$dir = '/var/www/uploads';
$flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS;

$iterator = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($dir, $flags),
    RecursiveIteratorIterator::SELF_FIRST // 先目录后文件，或 CHILD_FIRST
);

// 过滤：仅 .jpg/.png，大小 > 1MB
$filter = new RegexIterator($iterator, '/\.(jpg|png)$/i');
$filter = new CallbackFilterIterator($filter, function ($current) {
    return $current->getSize() > 1024 * 1024;
});

foreach ($filter as $path => $fileInfo) {
    /** @var SplFileInfo $fileInfo */
    echo "{$fileInfo->getPathname()} ({$fileInfo->getSize()} bytes)\n";
}

// 统计总数
$count = iterator_count($filter);
echo "Total: $count\n";

SPL 迭代器优势

• 内置过滤器链：RegexIterator、CallbackFilterIterator、FileTypeFilterIterator 组合无需手写判断。
• 文件信息对象化：SplFileInfo 提供 getSize()、getMTime()、getExtension()、isReadable() 等方法。
• 深度控制：RecursiveIteratorIterator::setMaxDepth($n) 限制递归层级。
• 标准接口：实现 Iterator/Countable，可直接 iterator_to_array、count()、foreach。

Windows 路径分隔符兼容

<?php
// 统一使用 DIRECTORY_SEPARATOR 常量
$path = $dir . DIRECTORY_SEPARATOR . $entry;
// 或实时规范化
$path = str_replace('/', DIRECTORY_SEPARATOR, $path);

性能基准（10万文件，SSD，PHP 8.2）

方案一 scandir+array_merge:  2.8s  峰值内存 180 MB
方案二 Generator:             1.9s  峰值内存 2 MB
方案三 SPL Iterator:          1.7s  峰值内存 3 MB

常见需求扩展

<?php
// 1. 按修改时间排序（需先收集数组）
$files = iterator_to_array(iterFiles($dir));
usort($files, fn($a, $b) => filemtime($b) <=> filemtime($a));

// 2. 计算目录总大小
$totalSize = 0;
foreach (iterFiles($dir) as $f) $totalSize += filesize($f);

// 3. 查找重复文件（MD5 分组）
$map = [];
foreach (iterFiles($dir) as $f) {
    $hash = md5_file($f);
    $map[$hash][] = $f;
}
$duplicates = array_filter($map, fn($v) => count($v) > 1);

总结

小目录、一次性脚本：scandir 递归最直观。
大目录、长时间运行、内存敏感：Generator 或 SPL RecursiveDirectoryIterator 二选一，SPL 功能更丰富，Generator 语法更灵活。现代 PHP 项目推荐默认使用 SPL 迭代器，配合过滤器链实现声明式文件遍历。