ApiBlock.php

Go to the documentation of this file.

<?php
class ApiBlock extends ApiBase {

    public function execute() {
        global $wgContLang;

        $user = $this->getUser();
        $params = $this->extractRequestParams();

        if ( !$user->isAllowed( 'block' ) ) {
            $this->dieUsageMsg( 'cantblock' );
        }

        # bug 15810: blocked admins should have limited access here
        if ( $user->isBlocked() ) {
            $status = SpecialBlock::checkUnblockSelf( $params['user'], $user );
            if ( $status !== true ) {
                $msg = $this->parseMsg( $status );
                $this->dieUsage(
                    $msg['info'],
                    $msg['code'],
                    0,
                    [ 'blockinfo' => ApiQueryUserInfo::getBlockInfo( $user->getBlock() ) ]
                );
            }
        }

        $target = User::newFromName( $params['user'] );
        // Bug 38633 - if the target is a user (not an IP address), but it
        // doesn't exist or is unusable, error.
        if ( $target instanceof User &&
            ( $target->isAnon() /* doesn't exist */ || !User::isUsableName( $target->getName() ) )
        ) {
            $this->dieUsageMsg( [ 'nosuchuser', $params['user'] ] );
        }

        if ( $params['hidename'] && !$user->isAllowed( 'hideuser' ) ) {
            $this->dieUsageMsg( 'canthide' );
        }
        if ( $params['noemail'] && !SpecialBlock::canBlockEmail( $user ) ) {
            $this->dieUsageMsg( 'cantblock-email' );
        }

        $data = [
            'PreviousTarget' => $params['user'],
            'Target' => $params['user'],
            'Reason' => [
                $params['reason'],
                'other',
                $params['reason']
            ],
            'Expiry' => $params['expiry'],
            'HardBlock' => !$params['anononly'],
            'CreateAccount' => $params['nocreate'],
            'AutoBlock' => $params['autoblock'],
            'DisableEmail' => $params['noemail'],
            'HideUser' => $params['hidename'],
            'DisableUTEdit' => !$params['allowusertalk'],
            'Reblock' => $params['reblock'],
            'Watch' => $params['watchuser'],
            'Confirm' => true,
        ];

        $retval = SpecialBlock::processForm( $data, $this->getContext() );
        if ( $retval !== true ) {
            // We don't care about multiple errors, just report one of them
            $this->dieUsageMsg( $retval );
        }

        list( $target, /*...*/ ) = SpecialBlock::getTargetAndType( $params['user'] );
        $res['user'] = $params['user'];
        $res['userID'] = $target instanceof User ? $target->getId() : 0;

        $block = Block::newFromTarget( $target, null, true );
        if ( $block instanceof Block ) {
            $res['expiry'] = $wgContLang->formatExpiry( $block->mExpiry, TS_ISO_8601, 'infinite' );
            $res['id'] = $block->getId();
        } else {
            # should be unreachable
            $res['expiry'] = '';
            $res['id'] = '';
        }

        $res['reason'] = $params['reason'];
        $res['anononly'] = $params['anononly'];
        $res['nocreate'] = $params['nocreate'];
        $res['autoblock'] = $params['autoblock'];
        $res['noemail'] = $params['noemail'];
        $res['hidename'] = $params['hidename'];
        $res['allowusertalk'] = $params['allowusertalk'];
        $res['watchuser'] = $params['watchuser'];

        $this->getResult()->addValue( null, $this->getModuleName(), $res );
    }

    public function mustBePosted() {
        return true;
    }

    public function isWriteMode() {
        return true;
    }

    public function getAllowedParams() {
        return [
            'user' => [
                ApiBase::PARAM_TYPE => 'user',
                ApiBase::PARAM_REQUIRED => true
            ],
            'expiry' => 'never',
            'reason' => '',
            'anononly' => false,
            'nocreate' => false,
            'autoblock' => false,
            'noemail' => false,
            'hidename' => false,
            'allowusertalk' => false,
            'reblock' => false,
            'watchuser' => false,
        ];
    }

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

    protected function getExamplesMessages() {
        // @codingStandardsIgnoreStart Generic.Files.LineLength
        return [
            'action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC'
                => 'apihelp-block-example-ip-simple',
            'action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC'
                => 'apihelp-block-example-user-complex',
        ];
        // @codingStandardsIgnoreEnd
    }

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