PHP 递归函数怎么遍历文件夹并输出文件列表-php教程-PHP中文网

scandir()配合递归是最直接的方式，需过滤.和..、校验is_dir()与is_readable()避免无限递归和警告；recursivedirectoryiterator更健壮但须try/catch捕获unexpectedvalueexception；路径安全应仅在入口处用realpath()校验，递归中避免重复解析；windows下注意max_path限制及符号链接循环。

php 递归函数怎么遍历文件夹并输出文件列表

用 `scandir()` 配合递归是最直接的方式

PHP 没有内置的“一键递归列出所有文件”函数，但 scandir() 返回目录下所有条目（含 . 和 ..），配合自己写的递归逻辑就能稳定工作。关键不是“能不能”，而是怎么安全跳过特殊目录、避免无限递归。

常见错误是没过滤 . 和 ..，导致当前目录和父目录被反复进入；还有没判断 is_dir() 就直接递归，遇到符号链接或权限不足时会报 Warning: scandir(): Failed to open dir。

实操建议：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

每次进入子目录前，先用 is_dir() 和 is_readable() 双重校验
显式跳过 . 和 .. —— 不要依赖 array_diff() 后再遍历，容易漏掉其他隐藏项
把路径拼接统一交给 dirname(__FILE__) 或 realpath() 开头，避免相对路径歧义

function listFiles($dir) {
    $items = scandir($dir);
    foreach ($items as $item) {
        if ($item === '.' || $item === '..') continue;
        $path = $dir . '/' . $item;
        if (is_dir($path)) {
            echo "DIR: $path
";
            listFiles($path); // 递归
        } else {
            echo "FILE: $path
";
        }
    }
}

用 `RecursiveDirectoryIterator` 更健壮但要注意异常捕获

面向对象方式更接近现代 PHP 风格，RecursiveDirectoryIterator 自动跳过 ./..，也支持 SkipDots 标志，但它在遇到不可读目录时默认抛出 UnexpectedValueException，不 catch 就会中断整个遍历。

适用场景：需要过滤特定扩展名、按修改时间排序、或后续要转成 RecursiveIteratorIterator 做扁平化处理。

实操建议：

必须用 try/catch 包裹 foreach 循环体，不能只包构造函数
用 getSubPathname() 而非 getPathname() 获取相对路径，方便控制输出粒度
如果只需要文件（不含目录），加一层 isFile() 判断，别只靠 isDir() 取反

$it = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS)
);
foreach ($it as $file) {
    try {
        if ($file->isFile()) {
            echo "FILE: " . $file->getPathname() . "
";
        }
    } catch (UnexpectedValueException $e) {
        // 权限不足或路径失效，跳过不中断
        continue;
    }
}