Method renameFile

src/FileRise/Domain/FileModel.php:1153–1202

* Renames a file within a given folder and updates folder metadata. * * @param string $folder The folder where the file is located (or "root" for the base directory). * @param string $oldName The current name of the file. * @param string $newName The new name for the file. * @return array An associative array with either "success" (and newName) or "error" message. */

($folder, $oldName, $newName)

     * @return array An associative array with either "success" (and newName) or "error" message.
     */
    public static function renameFile($folder, $oldName, $newName)
    {
        $storage = self::storage();
        list($directory, $err) = self::resolveFolderPath($folder, false);
        if ($err) {
            return ["error" => $err];
        }
        $directory .= DIRECTORY_SEPARATOR;

        // Sanitize file names.
        $oldName = basename(trim($oldName));
        $newName = basename(trim($newName));

        // Validate file names using REGEX_FILE_NAME.
        if (!preg_match(REGEX_FILE_NAME, $oldName) || !UploadNamePolicy::isAllowedForWrite($newName)) {
            return ["error" => "Invalid file name."];
        }

        $oldPath = $directory . $oldName;
        $newPath = $directory . $newName;

        // Helper: Generate a unique file name if the new name already exists.
        if ($storage->stat($newPath) !== null) {
            $newName = self::getUniqueFileName($directory, $newName);
            $newPath = $directory . $newName;
        }

        // Check that the old file exists.
        if ($storage->stat($oldPath) === null) {
            return ["error" => "File does not exist"];
        }

        // Perform the rename.
        if ($storage->move($oldPath, $newPath)) {
            // Update the metadata file.
            $metadataFile = self::getMetadataFilePath($folder);

            if (file_exists($metadataFile)) {
                $metadata = json_decode(file_get_contents($metadataFile), true);
                if (isset($metadata[$oldName])) {
                    $metadata[$newName] = $metadata[$oldName];
                    unset($metadata[$oldName]);
                    file_put_contents($metadataFile, json_encode($metadata, JSON_PRETTY_PRINT), LOCK_EX);
                }
            }
            return ["success" => "File renamed successfully", "newName" => $newName];
        } else {
            return ["error" => "Error renaming file"];
        }
    }

    /*
     * Save a file’s contents *and* record its metadata, including who uploaded it.