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

PHP遍历目录是开发中常见的操作,比如生成文件列表、扫描上传目录或清理缓存。PHP提供了多种方式来遍历指定目录下的文件和子目录,下面介绍几种常用方法,并附上实用示例。
使用 scandir() 函数遍历目录
scandir() 是最简单直接的目录遍历函数,它返回一个数组,包含目录中的所有文件和子目录名。
基本用法:
- 传入目录路径作为参数
- 可选择是否排序(默认升序)
- 需手动过滤 . 和 .. 这类特殊目录项
示例代码:
立即学习“PHP免费学习笔记(深入)”;
$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() 关闭句柄
示例代码:
立即学习“PHP免费学习笔记(深入)”;
$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。注意权限和路径安全,避免暴露敏感文件。











