本文详解如何在不使用内置迭代器类（如recursiveiterator）的前提下，用纯php实现安全、健壮的递归目录遍历，构建层级化的文件与子目录嵌套数组结构，并修复常见引用传递与路径处理错误。
本文详解如何在不使用内置迭代器类（如recursiveiterator）的前提下，用纯php实现安全、健壮的递归目录遍历，构建层级化的文件与子目录嵌套数组结构，并修复常见引用传递与路径处理错误。
在PHP中手动实现递归目录遍历是理解文件系统操作与函数式递归思想的重要实践。原代码存在两个核心缺陷：一是构造函数中误将局部变量 $_tree 赋值给未初始化的 $parent，导致递归调用时传入的是副本而非引用；二是未正确关闭目录句柄，且对隐藏文件（如 .git、.DS_Store）缺乏过滤，易引发逻辑混乱或权限异常。
以下为优化后的完整实现，采用返回值驱动设计（避免引用陷阱），增强健壮性与可维护性：
<?php
class H5AI {
public function __construct(string $path) {
if (!is_dir($path)) {
throw new InvalidArgumentException("Path '{$path}' is not a valid directory.");
}
print_r($this->getFiles($path));
}
public function getFiles(string $directory): array {
$handle = opendir($directory);
if ($handle === false) {
throw new RuntimeException("Cannot open directory: {$directory}");
}
$entries = [];
while (($entry = readdir($handle)) !== false) {
$fullPath = $directory . DIRECTORY_SEPARATOR . $entry;
// 跳过隐藏文件/目录（以点开头），但保留合法目录名如 '.well-known'
if (str_starts_with($entry, '.') && $entry !== '.' && $entry !== '..') {
continue;
}
if (is_file($fullPath)) {
$entries[] = $entry;
} elseif (is_dir($fullPath) && !in_array($entry, ['.', '..'], true)) {
// 递归获取子目录内容，并直接赋值为关联键
$entries[$entry] = $this->getFiles($fullPath);
}
}
closedir($handle); // 必须显式关闭，防止资源泄漏
return $entries;
}
}
// 使用示例（命令行运行）
// php index.php "./test_dir"
if (isset($argv[1])) {
new H5AI($argv[1]);
} else {
echo "Usage: php {$argv[0]} <directory_path>\n";
}✅ 关键改进说明：
- 无引用陷阱：不再传递 $parent 参数，而是让 getFiles() 每次返回新数组，通过递归调用结果直接赋值（$entries[$entry] = $this->getFiles($fullPath)），彻底规避变量作用域与引用丢失问题；
- 路径安全：统一使用 DIRECTORY_SEPARATOR 兼容 Windows/Linux；
- 异常防护：添加 opendir() 失败检查与参数校验，提升鲁棒性；
- 过滤策略合理：跳过以 . 开头的隐藏项（如 .gitignore），但允许显式列出 . 和 .. 判断逻辑（实际已由 in_array 排除）；
- 资源管理规范：显式调用 closedir()，符合PHP资源管理最佳实践。
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 避免无限递归：确保目标目录无符号链接循环（生产环境建议增加深度限制或已访问路径缓存）；
- 权限敏感：若遇到 Permission denied，需检查Web服务器或CLI用户对子目录的读取权限；
- 性能提示：对于超大目录，可考虑加入 set_time_limit(0) 或分批处理逻辑。
该方案完全满足课程约束（禁用 RecursiveIterator 等高级类），同时具备工业级清晰度与可扩展性，是理解PHP底层文件操作与递归建模的理想范例。
