Method restoreFiles

src/FileRise/Domain/FileModel.php:3188–3326

* Restores files from Trash based on an array of trash file identifiers. * * @param array $trashFiles An array of trash file names (i.e. the 'trashName' fields). * @return array An associative array with keys "restored" (an array of successfully restored items) * and optionally an "error" message if any issues occurred. */

(array $trashFiles)

     *               and optionally an "error" message if any issues occurred.
     */
    public static function restoreFiles(array $trashFiles)
    {
        $errors = [];
        $restoredItems = [];
        $storage = self::storage();

        // Setup Trash directory and trash metadata file.
        $trashDir = rtrim(self::trashRoot(), '/\\') . DIRECTORY_SEPARATOR;
        if ($storage->stat($trashDir) === null) {
            $storage->mkdir($trashDir, 0755, true);
        }
        $trashMetadataFile = $trashDir . "trash.json";
        $trashData = [];
        $trashJson = $storage->read($trashMetadataFile);
        if ($trashJson !== false) {
            $trashData = json_decode($trashJson, true);
        }
        if (!is_array($trashData)) {
            $trashData = [];
        }

        // Helper to get metadata file path for a folder.
        $getMetadataFilePath = static fn($folder): string => self::getMetadataFilePath((string)$folder);

        // Process each provided trash file name.
        foreach ($trashFiles as $trashFileName) {
            $trashFileName = trim($trashFileName);
            // Validate file name with REGEX_FILE_NAME.
            if (!preg_match(REGEX_FILE_NAME, $trashFileName)) {
                $errors[] = "$trashFileName has an invalid format.";
                continue;
            }

            // Locate the matching trash record.
            $recordKey = null;
            foreach ($trashData as $key => $record) {
                if (isset($record['trashName']) && $record['trashName'] === $trashFileName) {
                    $recordKey = $key;
                    break;
                }
            }
            if ($recordKey === null) {
                $errors[] = "No trash record found for $trashFileName.";
                continue;
            }

            $record = $trashData[$recordKey];
            if (!isset($record['originalFolder']) || !isset($record['originalName'])) {
                $errors[] = "Incomplete trash record for $trashFileName.";
                continue;
            }
            $originalFolder = $record['originalFolder'];
            $originalName = $record['originalName'];

            // Convert absolute original folder to relative folder.
            $relativeFolder = 'root';
            $root = rtrim(self::uploadRoot(), '/\\') . DIRECTORY_SEPARATOR;
            if (strpos($originalFolder, $root) === 0) {