Method renameFolder

src/FileRise/Domain/FolderModel.php:1856–1927

* Renames a folder and updates related metadata files (by renaming their filenames). * Also rewrites ownership keys for the whole subtree from old → new. */

(string $oldFolder, string $newFolder)

     * Also rewrites ownership keys for the whole subtree from old → new.
     */
    public static function renameFolder(string $oldFolder, string $newFolder): array
    {
        $oldFolder = trim($oldFolder, "/\\ ");
        $newFolder = trim($newFolder, "/\\ ");

        // Validate names (per-segment)
        foreach ([$oldFolder, $newFolder] as $f) {
            $parts = array_filter(explode('/', $f), fn($p) => $p !== '');
            if (empty($parts)) {
                return ["error" => "Invalid folder name(s)."];
            }
            foreach ($parts as $seg) {
                if (!preg_match(REGEX_FOLDER_NAME, $seg)) {
                    return ["error" => "Invalid folder name(s)."];
                }
            }
        }

        [$oldReal, $oldRel, $err] = self::resolveFolderPath($oldFolder, false);
        if ($err) {
            return ["error" => $err];
        }

        $storage = self::storage();
        $isLocal = $storage->isLocal();
        $base = $isLocal ? realpath(self::uploadRoot()) : rtrim(self::uploadRoot(), '/\\');
        if ($base === false || $base === '') {
            return ["error" => "Uploads directory not configured correctly."];
        }

        $newParts = array_filter(explode('/', $newFolder), fn($p) => $p !== '');
        $newRel   = implode('/', $newParts);
        $newPath  = $base . DIRECTORY_SEPARATOR . implode(DIRECTORY_SEPARATOR, $newParts);

        // Parent of new path must exist
        $newParent = dirname($newPath);
        if ($isLocal) {
            if (!is_dir($newParent) || strpos(realpath($newParent), $base) !== 0) {
                return ["error" => "Invalid folder path."];
            }
            if (file_exists($newPath)) {
                return ["error" => "New folder name already exists."];
            }
        } else {
            $parentStat = $storage->stat($newParent);
            if ($parentStat === null || ($parentStat['type'] ?? '') !== 'dir') {
                return ["error" => "Invalid folder path."];
            }
            if ($storage->stat($newPath) !== null) {
                return ["error" => "New folder name already exists."];
            }
        }
        if (!$storage->move($oldReal, $newPath)) {
            return ["error" => "Failed to rename folder."];
        }

        // Update metadata filenames (prefix-rename)
        MetadataPath::renameSubtree(self::metaRoot(), $oldRel, $newRel);