PHP递归遍历目录的几种方法

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《PHP递归遍历目录方法详解》，聊聊，我们一起来看看吧！

PHP中实现目录递归遍历的核心是使用递归函数结合scandir()和is_dir()处理子目录，而面对大目录或深层嵌套时，推荐采用SPL的RecursiveDirectoryIterator与RecursiveIteratorIterator，因其具备惰性加载、内存占用低、自动跳过.和..等优势，更适合大规模文件系统操作。传统递归方式直观灵活但易耗内存，SPL迭代器则更高效稳健，适用于复杂场景。

PHP中要实现目录的递归遍历，核心思路就是通过一个函数，检查当前目录下的所有文件和子目录。如果遇到文件，就处理它；如果遇到子目录，则再次调用这个函数去处理那个子目录，直到所有层级都被访问。这就像剥洋葱，一层一层地深入，直到最核心的部分。

解决方案

在PHP里，实现目录递归遍历通常会用到 scandir() 函数来获取目录内容，然后结合 is_dir() 判断是否为目录，再用递归调用来深入。

一个基础的递归遍历函数大概是这样：

function traverseDirectoryRecursive(string $path, callable $callback): void
{
    // 确保路径存在且可读
    if (!is_dir($path) || !is_readable($path)) {
        // 也许这里可以抛出异常或者记录日志，取决于具体需求
        // echo "Warning: Directory '{$path}' is not accessible or does not exist.\n";
        return;
    }

    $items = scandir($path);

    foreach ($items as $item) {
        // 跳过当前目录和上级目录的特殊条目
        if ($item === '.' || $item === '..') {
            continue;
        }

        $fullPath = rtrim($path, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $item;

        if (is_file($fullPath)) {
            // 如果是文件，执行回调函数
            $callback($fullPath, 'file');
        } elseif (is_dir($fullPath)) {
            // 如果是目录，先执行回调函数（可选，取决于你希望何时处理目录）
            $callback($fullPath, 'directory');
            // 然后递归调用自身，深入子目录
            traverseDirectoryRecursive($fullPath, $callback);
        }
    }
}

// 示例用法：打印所有文件和目录路径
echo "--- 递归遍历示例 ---\n";
$baseDir = __DIR__ . DIRECTORY_SEPARATOR . 'test_dir'; // 假设当前目录下有一个test_dir
// 为了演示，先创建一些测试目录和文件
if (!is_dir($baseDir)) {
    mkdir($baseDir, 0777, true);
    mkdir($baseDir . DIRECTORY_SEPARATOR . 'sub_dir1', 0777);
    file_put_contents($baseDir . DIRECTORY_SEPARATOR . 'file1.txt', 'Hello');
    file_put_contents($baseDir . DIRECTORY_SEPARATOR . 'sub_dir1' . DIRECTORY_SEPARATOR . 'file2.log', 'World');
    mkdir($baseDir . DIRECTORY_SEPARATOR . 'sub_dir1' . DIRECTORY_SEPARATOR . 'sub_sub_dir', 0777);
    file_put_contents($baseDir . DIRECTORY_SEPARATOR . 'sub_dir1' . DIRECTORY_SEPARATOR . 'sub_sub_dir' . DIRECTORY_SEPARATOR . 'file3.json', '{}');
}


traverseDirectoryRecursive($baseDir, function ($path, $type) {
    echo "Type: {$type}, Path: {$path}\n";
});

// 清理测试目录 (可选)
// function deleteDir($dirPath) {
//     if (! is_dir($dirPath)) {
//         return;
//     }
//     if (substr($dirPath, strlen($dirPath) - 1, 1) != '/') {
//         $dirPath .= '/';
//     }
//     $files = glob($dirPath . '*', GLOB_MARK);
//     foreach ($files as $file) {
//         if (is_dir($file)) {
//             deleteDir($file);
//         } else {
//             unlink($file);
//         }
//     }
//     rmdir($dirPath);
// }
// deleteDir($baseDir);

这个函数的核心在于 foreach 循环和 traverseDirectoryRecursive($fullPath, $callback); 这一行。当它发现一个子目录时，不是直接处理，而是把处理子目录的任务“扔”回给自己，这样就实现了层层递进。至于 scandir()，它会返回目录中的所有文件和目录名，包括 . 和 .. 这两个特殊项，所以我们需要手动跳过它们。

PHP递归遍历目录时，如何有效处理大目录或深层嵌套？

处理大型目录结构或深度嵌套时，传统的递归方式可能会遇到一些瓶颈，比如PHP默认的内存限制和执行时间限制，甚至更深层次的栈溢出问题。虽然PHP的递归深度通常很高，但在极端情况下，比如成千上万层嵌套，理论上还是有可能触及。

一个更健壮、更内存友好的方式是利用PHP的Standard PHP Library (SPL) 中的迭代器，特别是 RecursiveDirectoryIterator 和 RecursiveIteratorIterator。它们采用的是迭代而非递归的方式，这意味着它们不会一次性将所有文件和目录加载到内存中，而是按需读取。这对于处理海量文件系统来说，简直是救星。

echo "\n--- SPL 迭代器遍历示例 ---\n";
try {
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($baseDir, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::SELF_FIRST
    );

    foreach ($iterator as $fileInfo) {
        $type = $fileInfo->isDir() ? 'directory' : 'file';
        echo "Type: {$type}, Path: {$fileInfo->getPathname()}\n";
    }
} catch (UnexpectedValueException $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

RecursiveDirectoryIterator::SKIP_DOTS 选项能自动跳过 . 和 ..，省去了手动判断的麻烦。RecursiveIteratorIterator::SELF_FIRST 决定了是先遍历目录本身，还是先遍历其内容。这种迭代器模式的优势在于它提供了惰性加载，只在需要时才读取文件系统信息，大大降低了内存占用。对于权限问题，RecursiveDirectoryIterator 可能会抛出 UnexpectedValueException，所以用 try-catch 块捕获是个好习惯。

除了获取文件列表，递归遍历还能实现哪些进阶操作？

递归遍历目录不仅仅是获取文件列表那么简单，它的真正价值在于能够对文件系统中的每一个元素执行各种操作。这就像你拥有了一把万能钥匙，可以对任何一个房间（文件/目录）做你想做的事情。

1. 文件查找与过滤： 比如，我想找出某个目录下所有 .log 结尾的文件，或者所有大小超过1MB的图片文件。在回调函数中加入条件判断，就能轻松实现。

   // 查找所有 .log 文件
   traverseDirectoryRecursive($baseDir, function ($path, $type) {
       if ($type === 'file' && pathinfo($path, PATHINFO_EXTENSION) === 'log') {
           echo "Found log file: {$path}\n";
       }
   });

2. 批量操作： 想象一下你需要批量删除某个特定时间之前创建的所有临时文件，或者给所有HTML文件添加一个统一的页脚。递归遍历提供了一个完美的执行框架。

   // 批量删除所有空的子目录 (这需要更复杂的逻辑，可能需要后序遍历)
   // 或者批量修改文件权限
   traverseDirectoryRecursive($baseDir, function ($path, $type) {
       if ($type === 'file' && is_writable($path)) {
           // chmod($path, 0644); // 示例：修改文件权限
       }
   });

3. 目录结构复制或同步： 当你需要将一个目录下的所有内容，包括子目录和文件，完整地复制到另一个位置时，递归遍历是不可或缺的。你可以一边遍历源目录，一边在目标目录创建对应的结构和文件。
4. 文件内容分析或替换： 比如，在一个大型项目中搜索所有包含特定字符串的文件，或者批量替换代码中的旧变量名。通过 file_get_contents() 读取文件内容，然后进行字符串操作，再用 file_put_contents() 写回。
5. 生成文件索引或缓存： 对于一些内容管理系统，可能需要定期扫描文件系统，生成文件路径、大小、修改时间等信息的索引，以便快速查询。

这些进阶操作的核心都在于那个回调函数 $callback。它接收到文件或目录的完整路径和类型后，你可以根据业务逻辑自由发挥，实现几乎任何文件系统级别的自动化任务。

在PHP中，递归遍历目录与迭代器遍历目录有哪些优劣势？

这两种方法各有千秋，选择哪一种，往往取决于具体的场景和对性能、代码可读性的偏好。我个人在不同情况下会选择不同的方案，因为没有银弹。

1. 传统递归遍历（基于 scandir()）：

• 优势：
  • 直观易懂： 对于初学者来说，递归函数的逻辑相对容易理解，因为它直接模拟了人类“一层层深入”的思维方式。代码量可能也更少，对于简单的遍历任务显得很直接。
  • 灵活性： 你可以非常精细地控制在进入目录前、遍历目录中、离开目录后做什么操作。
• 劣势：
  • 内存消耗： 如果目录非常深或者包含大量文件，递归调用会在调用栈中积累，可能导致内存占用过高，甚至引发栈溢出（尽管PHP的默认栈深度很高，但极端情况仍可能发生）。
  • 性能： 每次 scandir() 都会读取整个目录内容，对于含有大量文件的目录，这可能不是最有效率的做法。
  • 错误处理： 需要手动处理 . 和 ..，以及文件权限等问题，代码中会有更多的条件判断。

2. SPL 迭代器遍历（基于 RecursiveDirectoryIterator）：

• 优势：
  • 内存效率高： 这是它最大的亮点。迭代器采用“惰性加载”机制，只在需要时才读取下一个文件或目录的信息，而不是一次性加载所有内容。这使得它非常适合处理大型或深度嵌套的文件系统，有效避免了内存溢出。
  • 代码简洁优雅： 结合 RecursiveIteratorIterator，代码通常更简洁，更具面向对象的风格。它也自动处理了 . 和 ..。
  • 可组合性强： SPL提供了丰富的迭代器，你可以将它们组合起来，实现更复杂的过滤、排序等功能，例如 RegexIterator、CallbackFilterIterator 等。
  • 性能： 通常情况下，迭代器的性能会优于手动递归，尤其是在处理大量文件时。
• 劣势：
  • 学习曲线： 对于不熟悉SPL迭代器模式的开发者来说，其概念和用法可能需要一些时间去理解和掌握。
  • 过度设计： 对于非常简单、层级不深的目录遍历任务，使用SPL迭代器可能会显得有些“杀鸡用牛刀”，增加了代码的复杂性而没有带来显著的好处。

总的来说，对于大多数日常任务，尤其是在处理可能规模较大的文件系统时，我更倾向于使用SPL迭代器。它提供了一种更健壮、更高效的解决方案。然而，如果我只是需要快速实现一个只有几层深度的简单遍历，并且对内存占用不那么敏感，那么一个简洁的递归函数也完全够用，甚至可能因为其直观性而更容易编写和调试。选择哪种方法，最终还是一个权衡的过程。

终于介绍完啦！小伙伴们，这篇关于《PHP递归遍历目录的几种方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！