SpecialRandompage.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
 
class RandomPage extends SpecialPage {
    private $namespaces; // namespaces to select pages from
    protected $isRedir = false; // should the result be a redirect?
    protected $extra = []; // Extra SQL statements
 
    public function __construct( $name = 'Randompage' ) {
        $this->namespaces = MediaWikiServices::getInstance()->getNamespaceInfo()->
            getContentNamespaces();
        parent::__construct( $name );
    }
 
    public function getNamespaces() {
        return $this->namespaces;
    }
 
    public function setNamespace( $ns ) {
        if ( !$ns || $ns < NS_MAIN ) {
            $ns = NS_MAIN;
        }
        $this->namespaces = [ $ns ];
    }
 
    // select redirects instead of normal pages?
    public function isRedirect() {
        return $this->isRedir;
    }
 
    public function execute( $par ) {
        if ( is_string( $par ) ) {
            // Testing for stringiness since we want to catch
            // the empty string to mean main namespace only.
            $this->setNamespace(
                MediaWikiServices::getInstance()->getContentLanguage()->getNsIndex( $par ) );
        }
 
        $title = $this->getRandomTitle();
 
        if ( is_null( $title ) ) {
            $this->setHeaders();
            // Message: randompage-nopages, randomredirect-nopages
            $this->getOutput()->addWikiMsg( strtolower( $this->getName() ) . '-nopages',
                $this->getNsList(), count( $this->namespaces ) );
 
            return;
        }
 
        $redirectParam = $this->isRedirect() ? [ 'redirect' => 'no' ] : [];
        $query = array_merge( $this->getRequest()->getValues(), $redirectParam );
        unset( $query['title'] );
        $this->getOutput()->redirect( $title->getFullURL( $query ) );
    }
 
    private function getNsList() {
        $contLang = MediaWikiServices::getInstance()->getContentLanguage();
        $nsNames = [];
        foreach ( $this->namespaces as $n ) {
            if ( $n === NS_MAIN ) {
                $nsNames[] = $this->msg( 'blanknamespace' )->plain();
            } else {
                $nsNames[] = $contLang->getNsText( $n );
            }
        }
 
        return $contLang->commaList( $nsNames );
    }
 
    public function getRandomTitle() {
        $randstr = wfRandom();
        $title = null;
 
        if ( !Hooks::run(
            'SpecialRandomGetRandomTitle',
            [ &$randstr, &$this->isRedir, &$this->namespaces, &$this->extra, &$title ]
        ) ) {
            return $title;
        }
 
        $row = $this->selectRandomPageFromDB( $randstr );
 
        /* If we picked a value that was higher than any in
         * the DB, wrap around and select the page with the
         * lowest value instead!  One might think this would
         * skew the distribution, but in fact it won't cause
         * any more bias than what the page_random scheme
         * causes anyway.  Trust me, I'm a mathematician. :)
         */
        if ( !$row ) {
            $row = $this->selectRandomPageFromDB( "0" );
        }
 
        if ( $row ) {
            return Title::makeTitleSafe( $row->page_namespace, $row->page_title );
        }
 
        return null;
    }
 
    protected function getQueryInfo( $randstr ) {
        $redirect = $this->isRedirect() ? 1 : 0;
        $tables = [ 'page' ];
        $conds = array_merge( [
            'page_namespace' => $this->namespaces,
            'page_is_redirect' => $redirect,
            'page_random >= ' . $randstr
        ], $this->extra );
        $joinConds = [];
 
        // Allow extensions to modify the query
        Hooks::run( 'RandomPageQuery', [ &$tables, &$conds, &$joinConds ] );
 
        return [
            'tables' => $tables,
            'fields' => [ 'page_title', 'page_namespace' ],
            'conds' => $conds,
            'options' => [
                'ORDER BY' => 'page_random',
                'LIMIT' => 1,
            ],
            'join_conds' => $joinConds
        ];
    }
 
    private function selectRandomPageFromDB( $randstr, $fname = __METHOD__ ) {
        $dbr = wfGetDB( DB_REPLICA );
 
        $query = $this->getQueryInfo( $randstr );
        $res = $dbr->select(
            $query['tables'],
            $query['fields'],
            $query['conds'],
            $fname,
            $query['options'],
            $query['join_conds']
        );
 
        return $dbr->fetchObject( $res );
    }
 
    protected function getGroupName() {
        return 'redirects';
    }
}