php遍历文件夹下所有文件 · 完全实战手册
从scandir到RecursiveDirectoryIterator,系统掌握PHP目录遍历技术。本站聚焦php遍历文件夹下所有文件的核心逻辑与网民实际搜索的高频问题。
① scandir 简单上手
使用scandir()快速获取目录文件列表,适合小型目录。返回数组包含`.`和`..`,需手动过滤。
② 递归自定义函数
通过递归函数遍历子文件夹,灵活控制深度与文件类型,经典php遍历文件夹方案。
③ RecursiveDirectoryIterator
SPL迭代器提供面向对象方式遍历,配合RecursiveIteratorIterator轻松展平目录树。
⚙️ 三种核心遍历方式
〓 scandir + 递归函数
php遍历文件夹下所有文件最基础的实现:自定义递归函数读取每个子目录。示例代码:
function listAllFiles($dir) {
$files = scandir($dir);
foreach ($files as $file) {
if ($file === '.' || $file === '..') continue;
$path = $dir . DIRECTORY_SEPARATOR . $file;
if (is_dir($path)) {
listAllFiles($path);
} else {
echo $path . "\n";
}
}
}
※ 注意设定基础目录,避免无限递归。可通过realpath()规范化路径。
〓 RecursiveDirectoryIterator 实战
使用SPL迭代器优雅处理php遍历文件夹,代码更简洁:
$iterator = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator('/path/to/folder', FilesystemIterator::SKIP_DOTS)
);
foreach ($iterator as $file) {
echo $file->getPathname() . "\n";
}
◣ 优势:自动跳过`.`和`..`,支持RegexIterator过滤文件类型。
〓 glob 模式匹配遍历
glob()函数支持通配符,可递归匹配子目录(需PHP 5.3+):
$files = glob('src/*.{php,txt}', GLOB_BRACE);
// 递归子目录 (使用一些技巧或递归glob)
function rglob($pattern, $flags = 0) {
$files = glob($pattern, $flags);
foreach (glob(dirname($pattern).'/*', GLOB_ONLYDIR|GLOB_NOSORT) as $dir) {
$files = array_merge($files, rglob($dir.'/'.basename($pattern), $flags));
}
return $files;
}
◤ 适合按扩展名筛选,网民常搜“php glob 遍历所有文件”。
📌 遍历流程时间轴
- ① 确定根目录 — 使用__DIR__或绝对路径,避免相对路径陷阱。
- ② 排除特殊目录 — 跳过`.`、`..`及隐藏文件夹(如`.git`)。
- ③ 递归或迭代读取 — 根据目录深度选择合适方法,php遍历文件夹下所有文件时注意内存。
- ④ 文件过滤 — 通过pathinfo()或正则匹配特定扩展名。
- ⑤ 结果存储或输出 — 可存入数组、数据库或直接生成文件列表。
🔍 网友们还关心
▪ 如何忽略某些文件夹?
在递归中加入黑名单数组,例如['vendor','node_modules'],使用in_array()判断跳过。
※ 按修改时间排序
遍历后使用filemtime()获取时间戳,通过usort排序数组,常用于展示最新文件。
※ 大目录性能优化
使用RecursiveDirectoryIterator配合LimitIterator分批处理,避免一次性加载百万文件。
🧠 深度技巧与周边
php遍历文件夹下所有文件常与文件搜索、批量重命名结合。网民还搜索“php 删除目录下所有文件”、“php 统计文件夹大小”。以下扩展知识:
▪ 过滤空目录
遍历时检查count(scandir($dir)) == 2 判断是否为空(仅含`.`和`..`)。
▪ 符号链接处理
使用is_link()检测,避免循环递归。迭代器可设置FOLLOW_SYMLINKS标志。
【示例】生成文件树状图
结合递归与缩进,输出可视化目录结构。网民常用此功能展示项目结构:
function tree($dir, $prefix = '') {
$files = scandir($dir);
foreach ($files as $file) {
if ($file === '.' || $file === '..') continue;
echo $prefix . '├── ' . $file . "\n";
if (is_dir($dir.'/'.$file)) {
tree($dir.'/'.$file, $prefix . '│ ');
}
}
}
⚡ 掌握php遍历文件夹下所有文件不仅是基础技能,更是构建文件管理系统、日志分析工具的核心。结合RecursiveCallbackFilterIterator可自定义复杂过滤规则。