Method scanFolderTreeForCopy

src/FileRise/Domain/FolderModel.php:1221–1329

(
        StorageAdapterInterface $storage,
        string $baseAbs,
        int $maxFiles,
        int $maxBytes,
        int $maxDepth
    )

    }

    private static function scanFolderTreeForCopy(
        StorageAdapterInterface $storage,
        string $baseAbs,
        int $maxFiles,
        int $maxBytes,
        int $maxDepth
    ): array {
        $queue = [
            ['abs' => $baseAbs, 'rel' => '', 'depth' => 0],
        ];
        $folders = [''];
        $filesByFolder = [];
        $errors = [];
        $fileCount = 0;
        $totalBytes = 0;

        $SKIP   = FS::SKIP();

        while ($queue) {
            $node = array_shift($queue);
            if (!is_array($node)) {
                continue;
            }
            $depth = (int)($node['depth'] ?? 0);
            if ($depth > $maxDepth) {
                return ['error' => 'Folder copy exceeds depth limit.'];
            }
            $abs = (string)($node['abs'] ?? '');
            if ($abs === '') {
                continue;
            }
            $rel = (string)($node['rel'] ?? '');

            $entries = $storage->list($abs);
            if (!$entries) {
                continue;
            }

            foreach ($entries as $name) {
                if ($name === '.' || $name === '..') {
                    continue;
                }
                if ($name === '' || $name[0] === '.') {
                    continue;
                }
                if (FS::shouldIgnoreEntry($name, $rel)) {
                    continue;
                }
                if (!FS::isSafeSegment($name)) {
                    continue;
                }

                $lower = strtolower($name);
                if (in_array($lower, $SKIP, true)) {
                    continue;
                }

                $childAbs = $abs . DIRECTORY_SEPARATOR . $name;