ApiFileRevert.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Api;
 
use MediaWiki\FileRepo\File\LocalFile;
use MediaWiki\FileRepo\RepoGroup;
use MediaWiki\Title\Title;
use Wikimedia\ParamValidator\ParamValidator;
 
class ApiFileRevert extends ApiBase {
    protected $file;
 
    protected $archiveName;
 
    protected $params;
 
    public function __construct(
        ApiMain $main,
        string $action,
        private readonly RepoGroup $repoGroup,
    ) {
        parent::__construct( $main, $action );
    }
 
    public function execute() {
        $this->useTransactionalTimeLimit();
 
        $this->params = $this->extractRequestParams();
        // Extract the file and archiveName from the request parameters
        $this->validateParameters();
 
        // Check whether we're allowed to revert this file
        $this->checkTitleUserPermissions( $this->file->getTitle(), [ 'edit', 'upload' ] );
        $rights = [ 'reupload' ];
        if ( $this->getUser()->equals( $this->file->getUploader() ) ) {
            // reupload-own is more basic, put it in the front for error messages.
            array_unshift( $rights, 'reupload-own' );
        }
        $this->checkUserRightsAny( $rights );
 
        $sourceUrl = $this->file->getArchiveVirtualUrl( $this->archiveName );
        $status = $this->file->upload(
            $sourceUrl,
            $this->params['comment'],
            $this->params['comment'],
            0,
            false,
            false,
            $this->getAuthority()
        );
 
        if ( $status->isGood() ) {
            $result = [ 'result' => 'Success' ];
        } else {
            $result = [
                'result' => 'Failure',
                'errors' => $this->getErrorFormatter()->arrayFromStatus( $status ),
            ];
        }
 
        $this->getResult()->addValue( null, $this->getModuleName(), $result );
    }
 
    protected function validateParameters() {
        // Validate the input title
        $title = Title::makeTitleSafe( NS_FILE, $this->params['filename'] );
        if ( $title === null ) {
            $this->dieWithError(
                [ 'apierror-invalidtitle', wfEscapeWikiText( $this->params['filename'] ) ]
            );
        }
        $localRepo = $this->repoGroup->getLocalRepo();
 
        // Check if the file really exists
        $this->file = $localRepo->newFile( $title );
        if ( !$this->file->exists() ) {
            $this->dieWithError( 'apierror-missingtitle' );
        }
 
        // Check if the archivename is valid for this file
        $this->archiveName = $this->params['archivename'];
        $oldFile = $localRepo->newFromArchiveName( $title, $this->archiveName );
        if ( !$oldFile->exists() ) {
            $this->dieWithError( 'filerevert-badversion' );
        }
    }
 
    public function mustBePosted() {
        return true;
    }
 
    public function isWriteMode() {
        return true;
    }
 
    public function getAllowedParams() {
        return [
            'filename' => [
                ParamValidator::PARAM_TYPE => 'string',
                ParamValidator::PARAM_REQUIRED => true,
            ],
            'comment' => [
                ParamValidator::PARAM_DEFAULT => '',
            ],
            'archivename' => [
                ParamValidator::PARAM_TYPE => 'string',
                ParamValidator::PARAM_REQUIRED => true,
            ],
        ];
    }
 
    public function needsToken() {
        return 'csrf';
    }
 
    protected function getExamplesMessages() {
        return [
            'action=filerevert&filename=Wiki.png&comment=Revert&' .
                'archivename=20110305152740!Wiki.png&token=123ABC'
                => 'apihelp-filerevert-example-revert',
        ];
    }
 
    public function getHelpUrls() {
        return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Filerevert';
    }
}
 
class_alias( ApiFileRevert::class, 'ApiFileRevert' );