本文详解如何正确使用 scandir() 编写递归函数遍历目录树，解决因路径拼接缺失和未过滤特殊目录项（`.` 和 `..`）导致的“foreach() argument must be of type array|object”警告问题，并提供健壮、可读性强的实现方案。
在 PHP 中，scandir() 是一个轻量级的目录读取函数，但它返回的是相对于当前工作目录的文件名列表（如 'index.php', 'src', '.', '..'），而非完整路径。初学者常犯的两个关键错误是：
- 误将单个文件名字符串当作数组传入递归调用（如 scan($path) 中 $path 是字符串 'logs'，而非 scandir('logs') 的结果）；
- 未跳过 . 和 .. 目录项，导致无限递归或 is_dir() 判断失败（因当前/上级目录在非绝对路径下可能不可访问）。
正确的做法是：每次递归调用前，先用 scandir() 读取目标子目录的内容，并确保传入的是合法的、可访问的绝对或相对路径。以下是修正后的完整实现：
function scan($location) {
// 使用 realpath() 确保路径有效，增强健壮性（可选）
$location = realpath($location);
if ($location === false) {
echo "Warning: Invalid path '$location'
";
return;
}
// 执行 scandir —— 关键：每次都在当前目录上下文中读取
$entries = scandir($location);
if ($entries === false) {
echo "Warning: Cannot read directory '$location'
";
return;
}
foreach ($entries as $entry) {
// 跳过 . 和 ..，避免循环引用与权限错误
if ($entry === '.' || $entry === '..') {
continue;
}
$fullPath = $location . DIRECTORY_SEPARATOR . $entry;
if (is_dir($fullPath)) {
echo "? $entry/
"; // 可视化标识目录
scan($fullPath); // ✅ 递归传入完整路径，下一层再 scandir
} else {
echo " ? $entry
"; // 缩进提升可读性
}
}
}
// 启动遍历（从当前目录开始）
scan('.');⚠️ 重要注意事项：
- scandir() 返回的条目名不带路径，因此必须手动拼接（推荐使用 DIRECTORY_SEPARATOR 保证跨平台兼容性）；
- 不要提前将整个目录树一次性 scandir() 后递归传递数组——这会丢失层级上下文，且违反函数设计意图；
- 生产环境建议改用 RecursiveDirectoryIterator + RecursiveIteratorIterator，它更安全、支持过滤、异常可控，且自动处理符号链接与权限边界；
- 若需输出树形结构（带缩进层级），可为函数增加 $depth 参数并动态生成 str_repeat(' ', $depth)。
总结：递归遍历的核心在于“每个递归层级独立执行 I/O 操作（如 scandir）并基于完整路径判断”，而非传递原始字符串或扁平化数组。理解路径语义与函数作用域，是写出可靠文件系统工具的第一步。
立即学习“PHP免费学习笔记（深入）”；
