PHP递归函数结果收集：构建文件系统扫描器

function readDirs($path , $result = []) // $result 默认按值传递
{
    $dirHandle = opendir($path);
    while($item = readdir($dirHandle)) 
    {
       $newPath = $path."/".$item;
       if(is_dir($newPath) && $item != '.' && $item != '..') 
       { 
         readDirs($newPath, $result); // 递归调用，传递的是 $result 的副本
       }
       elseif(!is_dir($newPath) && $item != '.DS_Store' && $item != '.' && $item != '..')
       { 
          // echo "$path<br>"; // 打印当前目录路径
          $result[] = $path; // 修改的是当前函数的 $result 副本
          return $result; // 过早的返回，中断了当前目录的扫描，也中断了父级对结果的期望
       }
    }
    // 如果没有文件，或者文件在当前目录处理完后，这里会隐式返回 null 或空的 $result
}

<?php

/**
 * 递归扫描指定目录及其子目录，收集所有文件的完整路径。
 *
 * @param string $path 要扫描的起始目录路径。
 * @return array 包含所有文件完整路径的数组。
 */
function getAllFilePathsRecursive(string $path): array
{
    $allFilePaths = []; // 初始化当前层级的结果数组

    // 检查路径是否有效且是可打开的目录
    if (!is_dir($path) || !($dirHandle = opendir($path))) {
        // 路径无效或无法打开目录，返回空数组
        error_log("无法打开目录: " . $path);
        return $allFilePaths;
    }

    while (false !== ($item = readdir($dirHandle))) {
        // 跳过当前目录 '.' 和上级目录 '..'
        if ($item === '.' || $item === '..') {
            continue;
        }

        // 构建完整的新路径，使用跨平台的目录分隔符
        $newPath = $path . DIRECTORY_SEPARATOR . $item;

        if (is_dir($newPath)) {
            // 如果是目录，递归调用自身，并将返回的结果与当前结果数组合并
            // array_merge 用于扁平化数组，避免嵌套
            $allFilePaths = array_merge($allFilePaths, getAllFilePathsRecursive($newPath));
        } else {
            // 如果是文件，将其完整路径添加到结果数组
            // 可以根据需要添加其他文件过滤条件，例如排除.DS_Store
            if ($item !== '.DS_Store') { // 排除macOS的隐藏文件
                $allFilePaths[] = $newPath;
            }
        }
    }
    closedir($dirHandle); // 关闭目录句柄，释放资源

    return $allFilePaths; // 返回当前层级收集到的所有文件路径
}

// 示例用法：
$basePath = "/Users/mycomputer/Documents/www/Photos_projets"; // 请替换为您的实际路径

// 检查起始路径是否存在且是目录
if (!is_dir($basePath)) {
    echo "错误：起始路径不存在或不是一个目录。\n";
} else {
    $collectedFilePaths = getAllFilePathsRecursive($basePath);

    echo "--- 收集到的文件路径 ---\n";
    if (empty($collectedFilePaths)) {
        echo "未找到任何文件。\n";
    } else {
        foreach ($collectedFilePaths as $filePath) {
            echo $filePath . "\n";
        }
        echo "总共收集到 " . count($collectedFilePaths) . " 个文件。\n";
    }
    // 您也可以使用 var_dump($collectedFilePaths); 来查看数组结构
}

?>