SpecialRedirect.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Exception\PermissionsError;
use MediaWiki\FileRepo\RepoGroup;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\SpecialPage\FormSpecialPage;
use MediaWiki\Status\Status;
use MediaWiki\Title\MalformedTitleException;
use MediaWiki\Title\Title;
use MediaWiki\User\UserFactory;
 
class SpecialRedirect extends FormSpecialPage {
 
    protected $mType;
 
    protected $mValue;
 
    public function __construct(
        private readonly RepoGroup $repoGroup,
        private readonly UserFactory $userFactory
    ) {
        parent::__construct( 'Redirect' );
        $this->mType = null;
        $this->mValue = null;
    }
 
    public function setParameter( $subpage ) {
        // parse $subpage to pull out the parts
        $parts = $subpage !== null ? explode( '/', $subpage, 2 ) : [];
        $this->mType = $parts[0] ?? null;
        $this->mValue = $parts[1] ?? null;
    }
 
    public function dispatchUser() {
        if ( !ctype_digit( $this->mValue ) ) {
            return Status::newFatal( 'redirect-not-numeric' );
        }
        $user = $this->userFactory->newFromId( (int)$this->mValue );
        $user->load(); // Make sure the id is validated by loading the user
        if ( $user->isAnon() ) {
            return Status::newFatal( 'redirect-not-exists' );
        }
        if ( $user->isHidden() && !$this->getAuthority()->isAllowed( 'hideuser' ) ) {
            throw new PermissionsError( null, [ 'badaccess-group0' ] );
        }
 
        return Status::newGood( [
            $user->getUserPage()->getFullURL( '', false, PROTO_CURRENT ), 302
        ] );
    }
 
    public function dispatchFile() {
        try {
            $title = Title::newFromTextThrow( $this->mValue, NS_FILE );
            if ( $title && !$title->inNamespace( NS_FILE ) ) {
                // If the given value contains a namespace enforce file namespace
                $title = Title::newFromTextThrow( Title::makeName( NS_FILE, $this->mValue ) );
            }
        } catch ( MalformedTitleException $e ) {
            return Status::newFatal( $e->getMessageObject() );
        }
        $file = $this->repoGroup->findFile( $title );
 
        if ( !$file || !$file->exists() ) {
            return Status::newFatal( 'redirect-not-exists' );
        }
        // Default behavior: Use the direct link to the file.
        $url = $file->getUrl();
        $request = $this->getRequest();
        $width = $request->getInt( 'width', -1 );
        $height = $request->getInt( 'height', -1 );
 
        // If a width is requested...
        if ( $width != -1 ) {
            $mto = $file->transform( [ 'width' => $width, 'height' => $height ] );
            // ... and we can
            if ( $mto && !$mto->isError() ) {
                // ... change the URL to point to a thumbnail.
                // Note: This url is more temporary as can change
                // if file is reuploaded and has different aspect ratio.
                $url = [ $mto->getUrl(), $height === -1 ? 301 : 302 ];
            }
        }
 
        return Status::newGood( $url );
    }
 
    public function dispatchRevision() {
        $oldid = $this->mValue;
        if ( !ctype_digit( $oldid ) ) {
            return Status::newFatal( 'redirect-not-numeric' );
        }
        $oldid = (int)$oldid;
        if ( $oldid === 0 ) {
            return Status::newFatal( 'redirect-not-exists' );
        }
 
        return Status::newGood( wfAppendQuery( wfScript( 'index' ), [
            'oldid' => $oldid
        ] ) );
    }
 
    public function dispatchPage() {
        $curid = $this->mValue;
        if ( !ctype_digit( $curid ) ) {
            return Status::newFatal( 'redirect-not-numeric' );
        }
        $curid = (int)$curid;
        if ( $curid === 0 ) {
            return Status::newFatal( 'redirect-not-exists' );
        }
 
        return Status::newGood( wfAppendQuery( wfScript( 'index' ), [
            'curid' => $curid
        ] ) );
    }
 
    public function dispatchLog() {
        $logid = $this->mValue;
        if ( !ctype_digit( $logid ) ) {
            return Status::newFatal( 'redirect-not-numeric' );
        }
        $logid = (int)$logid;
        if ( $logid === 0 ) {
            return Status::newFatal( 'redirect-not-exists' );
        }
        $query = [ 'title' => 'Special:Log', 'logid' => $logid ];
        return Status::newGood( wfAppendQuery( wfScript( 'index' ), $query ) );
    }
 
    private function dispatch() {
        // the various namespaces supported by Special:Redirect
        $status = match ( $this->mType ) {
            'user' => $this->dispatchUser(),
            'file' => $this->dispatchFile(),
            'revision' => $this->dispatchRevision(),
            'page' => $this->dispatchPage(),
            'logid' => $this->dispatchLog(),
            default => null
        };
        if ( $status && $status->isGood() ) {
            // These urls can sometimes be linked from prominent places,
            // so varnish cache.
            $value = $status->getValue();
            if ( is_array( $value ) ) {
                [ $url, $code ] = $value;
            } else {
                $url = $value;
                $code = 301;
            }
            if ( $code === 301 ) {
                $this->getOutput()->setCdnMaxage( 60 * 60 );
            } else {
                $this->getOutput()->setCdnMaxage( 10 );
            }
            $this->getOutput()->redirect( $url, $code );
 
            return true;
        }
        if ( $this->mValue !== null ) {
            $this->getOutput()->setStatusCode( 404 );
 
            // @phan-suppress-next-line PhanTypeMismatchReturnNullable Null of $status seems unreachable
            return $status;
        }
 
        return false;
    }
 
    protected function getFormFields() {
        return [
            'type' => [
                'type' => 'select',
                'label-message' => 'redirect-lookup',
                'options-messages' => [
                    'redirect-user' => 'user',
                    'redirect-page' => 'page',
                    'redirect-revision' => 'revision',
                    'redirect-file' => 'file',
                    'redirect-logid' => 'logid',
                ],
                'default' => $this->mType,
            ],
            'value' => [
                'type' => 'text',
                'label-message' => 'redirect-value',
                'default' => $this->mValue,
                'required' => true,
            ],
        ];
    }
 
    public function onSubmit( array $data ) {
        if ( !empty( $data['type'] ) && !empty( $data['value'] ) ) {
            $this->setParameter( $data['type'] . '/' . $data['value'] );
        }
 
        /* if this returns false, will show the form */
        return $this->dispatch();
    }
 
    public function onSuccess() {
        /* do nothing, we redirect in $this->dispatch if successful. */
    }
 
    protected function alterForm( HTMLForm $form ) {
        // tweak label on submit button
        $form->setSubmitTextMsg( 'redirect-submit' );
    }
 
    protected function getDisplayFormat() {
        return 'ooui';
    }
 
    protected function getSubpagesForPrefixSearch() {
        return [
            'file',
            'page',
            'revision',
            'user',
            'logid',
        ];
    }
 
    public function requiresPost() {
        return false;
    }
 
    protected function getGroupName() {
        return 'redirects';
    }
}
 
class_alias( SpecialRedirect::class, 'SpecialRedirect' );