PHP递归函数中收集目录扫描结果的正确姿势

function readDirs($path , $result = [])
{
    $dirHandle = opendir($path);
    while($item = readdir($dirHandle))
    {
       $newPath = $path."/".$item;
       if(is_dir($newPath) && $item != '.' && $item != '..')
       {
         readDirs($newPath, $result); // 问题点1：$result 按值传递
       }
       elseif(!is_dir($newPath) && $item != '.DS_Store' && $item != '.' && $item != '..')
       {
          echo "$path<br>";
          $result[] = $path; // 问题点2：修改的是局部副本
          return $result;    // 问题点3：过早返回，导致只收集到第一个文件所在的目录路径
       }
    }
}

$path =  "/Users/mycomputer/Documents/www/Photos_projets";
$results = array();
readDirs($path, $results); // $results 始终为空

function readDirs($path)
{
    $result = []; // 1. 为每个函数调用初始化一个局部结果集
    $dirHandle = opendir($path);

    // 增加错误处理，确保目录可打开
    if ($dirHandle === false) {
        return $result;
    }

    while($item = readdir($dirHandle))
    {
       $newPath = $path."/".$item;
       if(is_dir($newPath) && $item != '.' && $item != '..')
       {
         // 2. 递归调用子目录，并将子目录返回的结果追加到当前结果集中
         $result[] = readDirs($newPath);
       }
       elseif(!is_dir($newPath) && $item != '.DS_Store' && $item != '.' && $item != '..')
       {
          echo "$path<br>"; // 可以根据需要保留或移除
          $result[] = $path; // 3. 将当前文件所在目录的路径添加到结果集
          // return $result; // 4. 注意：此处的return会导致提前终止当前目录的扫描
       }
    }
    closedir($dirHandle); // 关闭目录句柄
    return $result; // 5. 返回当前层级累积的所有结果
}

$path =  "/Users/mycomputer/Documents/www/Photos_projets";
$finalResult = readDirs($path);
var_dump($finalResult);

/root
├── dir1
│   ├── fileA.txt
│   └── fileB.txt
├── dir2
│   └── fileC.txt
└── fileD.txt

array(2) {
  [0]=>
  array(1) {
    [0]=>
    string(10) "/root/dir1" // 找到fileA.txt后，dir1的扫描停止，返回
  }
  [1]=>
  array(1) {
    [0]=>
    string(10) "/root/dir2" // 找到fileC.txt后，dir2的扫描停止，返回
  }
  // 如果 /root 下有其他文件且在 dir1/dir2 之后被扫描，则会追加
  // 但由于 elseif 中的 return，如果 /root 目录下有文件，它会先返回，
  // 导致 dir1 和 dir2 的结果可能不会被包含。
  // 实际输出会非常依赖于 opendir/readdir 的顺序和 return 的位置。
  // 举例，如果 /root 下先找到 fileD.txt，那么整个函数可能就返回 ['/root']
}

function readDirsSafe($path) {
    $result = [];
    $dirHandle = @opendir($path); // 使用@抑制错误，并通过返回值判断
    if ($dirHandle === false) {
        error_log("无法打开目录: $path"); // 记录错误
        return $result;
    }
    // ... 循环处理 ...
    closedir($dirHandle);
    return $result;
}

function getAllFilePaths($path)
{
    $filePaths = [];
    $dirHandle = @opendir($path);
    if ($dirHandle === false) {
        error_log("无法打开目录: $path");
        return $filePaths;
    }

    while ($item = readdir($dirHandle))
    {
        if ($item == '.' || $item == '..') {
            continue;
        }

        $itemPath = $path . "/" . $item;

        if (is_dir($itemPath)) {
            // 递归调用并合并子目录返回的文件路径
            $filePaths = array_merge($filePaths, getAllFilePaths($itemPath));
        } elseif (is_file($itemPath) && $item != '.DS_Store') {
            // 将文件本身的路径添加到结果集
            $filePaths[] = $itemPath;
        }
    }
    closedir($dirHandle);
    return $filePaths;
}

$path = "/Users/mycomputer/Documents/www/Photos_projets";
$allFiles = getAllFilePaths($path);
var_dump($allFiles);

function getAllFilePathsSPL