本文详解如何在不使用 php 内置迭代器（如 recursivedirectoryiterator）的前提下，编写健壮、可读性强的递归函数，实现任意深度目录的遍历，并以嵌套关联数组形式精确表示文件与子目录层级关系。
本文详解如何在不使用 php 内置迭代器（如 recursivedirectoryiterator）的前提下，编写健壮、可读性强的递归函数，实现任意深度目录的遍历，并以嵌套关联数组形式精确表示文件与子目录层级关系。
在开发轻量级文件索引工具（如模拟 h5ai 的目录浏览功能）时，常需手动构建目录树结构。受限于教学要求或运行环境（如旧版 PHP），无法依赖 RecursiveIterator 系列类，此时必须通过原生 opendir()/readdir() + 递归调用来实现。核心挑战在于：正确区分文件与目录、安全跳过特殊条目（.、..）、确保递归调用结果被准确注入父级数组对应键下，而非丢失或覆盖。
以下是一个经过优化、生产就绪的实现方案：
<?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) {
// 跳过隐藏文件/目录（以 . 开头），可根据需求调整
if (str_starts_with($entry, '.')) {
continue;
}
$fullPath = $directory . DIRECTORY_SEPARATOR . $entry;
if (is_file($fullPath)) {
$entries[] = $entry; // 普通文件：追加至索引数组
} elseif (is_dir($fullPath)) {
// 子目录：递归调用，并将返回的嵌套数组赋值给当前目录名键
$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";
}关键改进点说明
- 参数与返回值类型声明：显式标注 string 类型和 array 返回类型，增强可维护性与 IDE 支持；
- 错误防御机制：构造函数校验路径有效性，opendir() 失败时抛出异常，避免静默失败；
- 逻辑精简与语义清晰：移除冗余属性（如 $_tree、$_path）和无意义中间变量（如 $parent），直接通过函数返回值组合数据结构；
- 正确递归注入：$entries[$entry] = $this->getFiles($path) 确保子目录的完整嵌套结构被原样嵌入，而非传入空数组引用导致内容丢失（原问题中 $parent[$entry] = [] 后未更新该引用）；
- 安全过滤：默认跳过所有以 . 开头的条目（含 .git、.DS_Store 等），并显式排除 . 和 ..，避免无限递归；
- 资源管理：严格配对 opendir() / closedir()，防止句柄泄漏。
注意事项
- 性能提示：对于超大目录，此纯递归方式可能触发 PHP 默认的 max_execution_time 或 xdebug.max_nesting_level 限制，生产环境建议结合生成器（Generator）改写为迭代式遍历；
- 权限与符号链接：is_dir() 和 is_file() 受限于 PHP 进程的文件系统权限；若需处理符号链接，可使用 is_link() 单独判断并决定是否跟随（默认不跟随）；
- Windows 兼容性：DIRECTORY_SEPARATOR 确保路径分隔符跨平台兼容，无需硬编码 / 或 \；
- 扩展性建议：如需支持文件元信息（大小、修改时间），可在 is_file() 分支中调用 stat() 并存为关联子数组。
该实现既满足教学约束，又具备工程可用性，是理解 PHP 文件系统操作与递归设计思想的典型范例。
