Method resolveFolderPathForAdapter

src/FileRise/Domain/FileModel.php:187–231

(
        StorageAdapterInterface $storage,
        string $root,
        string $folder,
        bool $create = true
    )

    }

    private static function resolveFolderPathForAdapter(
        StorageAdapterInterface $storage,
        string $root,
        string $folder,
        bool $create = true
    ): array {
        $folder = trim($folder) ?: 'root';

        if (strtolower($folder) !== 'root' && !preg_match(REGEX_FOLDER_NAME, $folder)) {
            return [null, "Invalid folder name."];
        }

        $isLocal = $storage->isLocal();
        $base = $isLocal ? realpath($root) : rtrim($root, '/\\');
        if ($base === false || $base === '') {
            return [null, "Server misconfiguration."];
        }

        if (!$isLocal && strpos($folder, '..') !== false) {
            return [null, "Invalid folder name."];
        }

        $dir = (strtolower($folder) === 'root')
            ? $base
            : $base . DIRECTORY_SEPARATOR . trim($folder, "/\\ ");

        if ($create) {
            $st = $storage->stat($dir);
            if ($st === null || $st['type'] !== 'dir') {
                if (!$storage->mkdir($dir, 0775, true)) {
                    return [null, "Cannot create destination folder"];
                }
            }
        }

        if ($isLocal) {
            $real = realpath($dir);
            if ($real === false || strpos($real, $base) !== 0) {
                return [null, "Invalid folder path."];
            }
            return [$real, null];
        }

        return [$dir, null];
    }

    /**
     * Copies files from a source folder to a destination folder, updating metadata if available.