php遍历一个文件夹下的所有文件和子文件夹

封面图 • 2026-01-17 • PHP

在 PHP 中，你可以使用 `DirectoryIterator` 或 `scandir()` 函数来遍历一个文件夹下的所有文件和子文件夹。下面是一个使用 `DirectoryIterator` 的示例，它可以递归地遍历整个目录结构：

---

### ✅ 示例：使用 `DirectoryIterator` 遍历文件夹（包括子文件夹）

```php
<?php

function traverseDirectory($path) {
    $dir = new DirectoryIterator($path);

foreach ($dir as $item) {
        if ($item->isDir() && !$item->isDot()) {
            echo "目录: " . $item->getRealPath() . "\n";
            // 递归遍历子目录
            traverseDirectory($item->getRealPath());
        } elseif ($item->isFile()) {
            echo "文件: " . $item->getRealPath() . "\n";
        }
    }
}

// 调用函数，传入要遍历的文件夹路径
traverseDirectory('/path/to/your/folder');
```

---

### 📝 说明：

- `DirectoryIterator` 是一个面向对象的类，可以方便地遍历目录。
- `$item->isDir()` 检查是否是目录。
- `$item->isFile()` 检查是否是文件。
- `$item->isDot()` 用于跳过 `.` 和 `..` 这两个特殊目录。
- `getRealPath()` 获取文件或目录的绝对路径。

---

### 🔄 如果你希望获取所有文件和目录的列表（如数组形式）：

```php
function getFilesAndFolders($path) {
    $result = [];

$dir = new DirectoryIterator($path);

foreach ($dir as $item) {
        if ($item->isDir() && !$item->isDot()) {
            $result[] = [
                'type' => 'directory',
                'path' => $item->getRealPath()
            ];
            // 递归获取子目录内容
            $result = array_merge($result, getFilesAndFolders($item->getRealPath()));
        } elseif ($item->isFile()) {
            $result[] = [
                'type' => 'file',
                'path' => $item->getRealPath()
            ];
        }
    }

return $result;
}

// 使用示例
$filesAndFolders = getFilesAndFolders('/path/to/your/folder');

foreach ($filesAndFolders as $item) {
    echo $item['type'] . ": " . $item['path'] . "\n";
}
```

---

### ⚠️ 注意事项：

- 确保 PHP 有权限访问目标目录。
- 如果目录层级很深，可能需要调整 `max_execution_time` 或使用 `set_time_limit(0)` 来避免超时。
- 如果目录中包含大量文件，建议分页处理或限制遍历深度。

---

如果你有特定需求（比如只遍历某些类型的文件、过滤文件名等），欢迎继续提问！