PHP遍历目录文件及子目录方法

一分耕耘，一分收获！既然打开了这篇文章《PHP遍历目录文件与子目录方法》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

答案：PHP提供scandir()、opendir/readdir()和RecursiveDirectoryIterator三种目录遍历方法，分别适用于简单列表、大目录和递归扫描场景。

PHP遍历目录是开发中常见的操作，比如生成文件列表、扫描上传目录或清理缓存。PHP提供了多种方式来遍历指定目录下的文件和子目录，下面介绍几种常用方法，并附上实用示例。

使用 scandir() 函数遍历目录

scandir() 是最简单直接的目录遍历函数，它返回一个数组，包含目录中的所有文件和子目录名。

基本用法：

• 传入目录路径作为参数
• 可选择是否排序（默认升序）
• 需手动过滤 . 和 .. 这类特殊目录项

示例代码：

$dir = './test_dir/';
if (is_dir($dir)) {
    $files = scandir($dir);
    foreach ($files as $file) {
        if ($file !== '.' && $file !== '..') {
            echo $file . "\n";
        }
    }
}

使用 opendir() + readdir() 逐个读取

这种方式更灵活，适合大目录处理，避免一次性加载所有条目到内存。

步骤说明：

• 用 opendir() 打开目录句柄
• 用 readdir() 循环读取每个条目
• 用 closedir() 关闭句柄

示例代码：

$dir = './test_dir/';
if ($handle = opendir($dir)) {
    while (($file = readdir($handle)) !== false) {
        if ($file != '.' && $file != '..') {
            echo $file . "\n";
        }
    }
    closedir($handle);
}

使用 RecursiveDirectoryIterator 遍历深层结构

如果需要递归遍历子目录中的子目录，推荐使用 SPL 提供的迭代器类。

RecursiveDirectoryIterator 结合 RecursiveIteratorIterator 可以轻松实现全目录扫描。

优势：

• 自动处理嵌套目录
• 支持面向对象语法
• 可配合过滤器使用

示例：列出所有文件和子目录路径

$iterator = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator('./test_dir/')
);

foreach ($iterator as $file) {
    echo $file->getPathname() . "\n";
}

只获取文件或只获取目录的过滤技巧

实际应用中常需区分文件和目录。可以结合 is_file() 和 is_dir() 进行判断。

例如：仅列出文件

$dir = './test_dir/';
if (is_dir($dir) && ($files = scandir($dir))) {
    foreach ($files as $item) {
        if ($item !== '.' && $item !== '..') {
            $path = $dir . $item;
            if (is_file($path)) {
                echo "文件: " . $item . "\n";
            }
        }
    }
}

同理，判断 is_dir() 可筛选出子目录。

基本上就这些。根据需求选择合适的方法：简单场景用 scandir()，大目录用 opendir/readdir，深度遍历用 RecursiveDirectoryIterator。注意权限和路径安全，避免暴露敏感文件。

到这里，我们也就讲完了《PHP遍历目录文件及子目录方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于PHP基础语法的知识点！