Method moveFiles

src/FileRise/Domain/FileModel.php:1001–1143

* Moves files from a source folder to a destination folder and updates metadata. * * @param string $sourceFolder The source folder (e.g., "root" or a subfolder). * @param string $destinationFolder The destination folder. * @param array $files An array of file names to move. * @return array An associative array with either a "success" key or an "error" key. */

($sourceFolder, $destinationFolder, $files)

     * @return array An associative array with either a "success" key or an "error" key.
     */
    public static function moveFiles($sourceFolder, $destinationFolder, $files)
    {
        $errors = [];
        $storage = self::storage();
        $isLocal = $storage->isLocal();

        list($sourceDir, $err) = self::resolveFolderPath($sourceFolder, false);
        if ($err) {
            return ["error" => $err];
        }
        list($destDir, $err)   = self::resolveFolderPath($destinationFolder, true);
        if ($err) {
            return ["error" => $err];
        }

        $sourceDir .= DIRECTORY_SEPARATOR;
        $destDir   .= DIRECTORY_SEPARATOR;

        // Get metadata file paths.
        $srcMetaFile  = self::getMetadataFilePath($sourceFolder);
        $destMetaFile = self::getMetadataFilePath($destinationFolder);

        $srcMetadata  = file_exists($srcMetaFile)  ? json_decode(file_get_contents($srcMetaFile), true)  : [];
        $destMetadata = file_exists($destMetaFile) ? json_decode(file_get_contents($destMetaFile), true) : [];
        if (!is_array($srcMetadata)) {
            $srcMetadata = [];
        }
        if (!is_array($destMetadata)) {
            $destMetadata = [];
        }

        $destEncrypted = false;
        try {
            $destEncrypted = FolderCrypto::isEncryptedOrAncestor((string)$destinationFolder);
        } catch (\Throwable $e) {
            $destEncrypted = false;
        }
        $srcEncrypted = false;
        try {
            $srcEncrypted = FolderCrypto::isEncryptedOrAncestor((string)$sourceFolder);
        } catch (\Throwable $e) {
            $srcEncrypted = false;
        }
        if (!$isLocal && ($srcEncrypted || $destEncrypted)) {
            return ["error" => "Encrypted folders are not supported for remote storage."];
        }

        $movedFiles = [];
        $safeFileNamePattern = REGEX_FILE_NAME;

        foreach ($files as $fileName) {
            // Save the original file name for metadata lookup.
            $originalName = basename(trim($fileName));
            $basename = $originalName;

            // Validate the file name.
            if (!preg_match($safeFileNamePattern, $basename)) {
                $errors[] = "$basename has invalid characters.";