ApiMergeHistory.php

Go to the documentation of this file.

<?php
class ApiMergeHistory extends ApiBase {

    public function execute() {
        $this->useTransactionalTimeLimit();

        $params = $this->extractRequestParams();

        $this->requireOnlyOneParameter( $params, 'from', 'fromid' );
        $this->requireOnlyOneParameter( $params, 'to', 'toid' );

        // Get page objects (nonexistant pages get caught in MergeHistory::isValidMerge())
        if ( isset( $params['from'] ) ) {
            $fromTitle = Title::newFromText( $params['from'] );
            if ( !$fromTitle || $fromTitle->isExternal() ) {
                $this->dieUsageMsg( [ 'invalidtitle', $params['from'] ] );
            }
        } elseif ( isset( $params['fromid'] ) ) {
            $fromTitle = Title::newFromID( $params['fromid'] );
            if ( !$fromTitle ) {
                $this->dieUsageMsg( [ 'nosuchpageid', $params['fromid'] ] );
            }
        }

        if ( isset( $params['to'] ) ) {
            $toTitle = Title::newFromText( $params['to'] );
            if ( !$toTitle || $toTitle->isExternal() ) {
                $this->dieUsageMsg( [ 'invalidtitle', $params['to'] ] );
            }
        } elseif ( isset( $params['toid'] ) ) {
            $toTitle = Title::newFromID( $params['toid'] );
            if ( !$toTitle ) {
                $this->dieUsageMsg( [ 'nosuchpageid', $params['toid'] ] );
            }
        }

        $reason = $params['reason'];
        $timestamp = $params['timestamp'];

        // Merge!
        $status = $this->merge( $fromTitle, $toTitle, $timestamp, $reason );
        if ( !$status->isOK() ) {
            $this->dieStatus( $status );
        }

        $r = [
            'from' => $fromTitle->getPrefixedText(),
            'to' => $toTitle->getPrefixedText(),
            'timestamp' => wfTimestamp( TS_ISO_8601, $params['timestamp'] ),
            'reason' => $params['reason']
        ];
        $result = $this->getResult();

        $result->addValue( null, $this->getModuleName(), $r );
    }

    protected function merge( Title $from, Title $to, $timestamp, $reason ) {
        $mh = new MergeHistory( $from, $to, $timestamp );

        return $mh->merge( $this->getUser(), $reason );
    }

    public function mustBePosted() {
        return true;
    }

    public function isWriteMode() {
        return true;
    }

    public function getAllowedParams() {
        return [
            'from' => null,
            'fromid' => [
                ApiBase::PARAM_TYPE => 'integer'
            ],
            'to' => null,
            'toid' => [
                ApiBase::PARAM_TYPE => 'integer'
            ],
            'timestamp' => [
                ApiBase::PARAM_TYPE => 'timestamp'
            ],
            'reason' => '',
        ];
    }

    public function needsToken() {
        return 'csrf';
    }

    protected function getExamplesMessages() {
        return [
            'action=mergehistory&from=Oldpage&to=Newpage&token=123ABC&' .
            'reason=Reason'
            => 'apihelp-mergehistory-example-merge',
            'action=mergehistory&from=Oldpage&to=Newpage&token=123ABC&' .
            'reason=Reason&timestamp=2015-12-31T04%3A37%3A41Z' // TODO
            => 'apihelp-mergehistory-example-merge-timestamp',
        ];
    }

    public function getHelpUrls() {
        return 'https://www.mediawiki.org/wiki/API:Mergehistory';
    }
}