QueryPage.php

Go to the documentation of this file.

<?php
abstract class QueryPage extends SpecialPage {
    protected $listoutput = false;

    protected $offset = 0;

    protected $limit = 0;

    protected $numRows;

    protected $cachedTimestamp = null;

    protected $shownavigation = true;

    public static function getPages() {
        global $wgDisableCounters;
        static $qp = null;

        if ( $qp === null ) {
            // QueryPage subclass, Special page name
            $qp = array(
                array( 'AncientPagesPage', 'Ancientpages' ),
                array( 'BrokenRedirectsPage', 'BrokenRedirects' ),
                array( 'DeadendPagesPage', 'Deadendpages' ),
                array( 'DoubleRedirectsPage', 'DoubleRedirects' ),
                array( 'FileDuplicateSearchPage', 'FileDuplicateSearch' ),
                array( 'ListDuplicatedFilesPage', 'ListDuplicatedFiles'),
                array( 'LinkSearchPage', 'LinkSearch' ),
                array( 'ListredirectsPage', 'Listredirects' ),
                array( 'LonelyPagesPage', 'Lonelypages' ),
                array( 'LongPagesPage', 'Longpages' ),
                array( 'MediaStatisticsPage', 'MediaStatistics' ),
                array( 'MIMEsearchPage', 'MIMEsearch' ),
                array( 'MostcategoriesPage', 'Mostcategories' ),
                array( 'MostimagesPage', 'Mostimages' ),
                array( 'MostinterwikisPage', 'Mostinterwikis' ),
                array( 'MostlinkedCategoriesPage', 'Mostlinkedcategories' ),
                array( 'MostlinkedtemplatesPage', 'Mostlinkedtemplates' ),
                array( 'MostlinkedPage', 'Mostlinked' ),
                array( 'MostrevisionsPage', 'Mostrevisions' ),
                array( 'FewestrevisionsPage', 'Fewestrevisions' ),
                array( 'ShortPagesPage', 'Shortpages' ),
                array( 'UncategorizedCategoriesPage', 'Uncategorizedcategories' ),
                array( 'UncategorizedPagesPage', 'Uncategorizedpages' ),
                array( 'UncategorizedImagesPage', 'Uncategorizedimages' ),
                array( 'UncategorizedTemplatesPage', 'Uncategorizedtemplates' ),
                array( 'UnusedCategoriesPage', 'Unusedcategories' ),
                array( 'UnusedimagesPage', 'Unusedimages' ),
                array( 'WantedCategoriesPage', 'Wantedcategories' ),
                array( 'WantedFilesPage', 'Wantedfiles' ),
                array( 'WantedPagesPage', 'Wantedpages' ),
                array( 'WantedTemplatesPage', 'Wantedtemplates' ),
                array( 'UnwatchedPagesPage', 'Unwatchedpages' ),
                array( 'UnusedtemplatesPage', 'Unusedtemplates' ),
                array( 'WithoutInterwikiPage', 'Withoutinterwiki' ),
            );
            wfRunHooks( 'wgQueryPages', array( &$qp ) );

            if ( !$wgDisableCounters ) {
                $qp[] = array( 'PopularPagesPage', 'Popularpages' );
            }
        }

        return $qp;
    }

    function setListoutput( $bool ) {
        $this->listoutput = $bool;
    }

    function getQueryInfo() {
        return null;
    }

    function getSQL() {
        /* Implement getQueryInfo() instead */
        throw new MWException( "Bug in a QueryPage: doesn't implement getQueryInfo() nor "
            . "getQuery() properly" );
    }

    function getOrderFields() {
        return array( 'value' );
    }

    function usesTimestamps() {
        return false;
    }

    function sortDescending() {
        return true;
    }

    function isExpensive() {
        return $this->getConfig()->get( 'DisableQueryPages' );
    }

    public function isCacheable() {
        return true;
    }

    function isCached() {
        return $this->isExpensive() && $this->getConfig()->get( 'MiserMode' );
    }

    function isSyndicated() {
        return true;
    }

    abstract function formatResult( $skin, $result );

    function getPageHeader() {
        return '';
    }

    function linkParameters() {
        return array();
    }

    function tryLastResult() {
        return false;
    }

    function recache( $limit, $ignoreErrors = true ) {
        if ( !$this->isCacheable() ) {
            return 0;
        }

        $fname = get_class( $this ) . '::recache';
        $dbw = wfGetDB( DB_MASTER );
        if ( !$dbw ) {
            return false;
        }

        try {
            # Do query
            $res = $this->reallyDoQuery( $limit, false );
            $num = false;
            if ( $res ) {
                $num = $res->numRows();
                # Fetch results
                $vals = array();
                foreach ( $res as $row ) {
                    if ( isset( $row->value ) ) {
                        if ( $this->usesTimestamps() ) {
                            $value = wfTimestamp( TS_UNIX,
                                $row->value );
                        } else {
                            $value = intval( $row->value ); // @bug 14414
                        }
                    } else {
                        $value = 0;
                    }

                    $vals[] = array( 'qc_type' => $this->getName(),
                            'qc_namespace' => $row->namespace,
                            'qc_title' => $row->title,
                            'qc_value' => $value );
                }

                $dbw->startAtomic( __METHOD__ );
                # Clear out any old cached data
                $dbw->delete( 'querycache', array( 'qc_type' => $this->getName() ), $fname );
                # Save results into the querycache table on the master
                if ( count( $vals ) ) {
                    $dbw->insert( 'querycache', $vals, __METHOD__ );
                }
                # Update the querycache_info record for the page
                $dbw->delete( 'querycache_info', array( 'qci_type' => $this->getName() ), $fname );
                $dbw->insert( 'querycache_info',
                    array( 'qci_type' => $this->getName(), 'qci_timestamp' => $dbw->timestamp() ),
                    $fname );
                $dbw->endAtomic( __METHOD__ );
            }
        } catch ( DBError $e ) {
            if ( !$ignoreErrors ) {
                throw $e; // report query error
            }
            $num = false; // set result to false to indicate error
        }

        return $num;
    }

    function getRecacheDB() {
        return wfGetDB( DB_SLAVE, array( $this->getName(), 'QueryPage::recache', 'vslow' ) );
    }

    function reallyDoQuery( $limit, $offset = false ) {
        $fname = get_class( $this ) . "::reallyDoQuery";
        $dbr = $this->getRecacheDB();
        $query = $this->getQueryInfo();
        $order = $this->getOrderFields();

        if ( $this->sortDescending() ) {
            foreach ( $order as &$field ) {
                $field .= ' DESC';
            }
        }

        if ( is_array( $query ) ) {
            $tables = isset( $query['tables'] ) ? (array)$query['tables'] : array();
            $fields = isset( $query['fields'] ) ? (array)$query['fields'] : array();
            $conds = isset( $query['conds'] ) ? (array)$query['conds'] : array();
            $options = isset( $query['options'] ) ? (array)$query['options'] : array();
            $join_conds = isset( $query['join_conds'] ) ? (array)$query['join_conds'] : array();

            if ( count( $order ) ) {
                $options['ORDER BY'] = $order;
            }

            if ( $limit !== false ) {
                $options['LIMIT'] = intval( $limit );
            }

            if ( $offset !== false ) {
                $options['OFFSET'] = intval( $offset );
            }

            $res = $dbr->select( $tables, $fields, $conds, $fname,
                    $options, $join_conds
            );
        } else {
            // Old-fashioned raw SQL style, deprecated
            $sql = $this->getSQL();
            $sql .= ' ORDER BY ' . implode( ', ', $order );
            $sql = $dbr->limitResult( $sql, $limit, $offset );
            $res = $dbr->query( $sql, $fname );
        }

        return $res;
    }

    function doQuery( $offset = false, $limit = false ) {
        if ( $this->isCached() && $this->isCacheable() ) {
            return $this->fetchFromCache( $limit, $offset );
        } else {
            return $this->reallyDoQuery( $limit, $offset );
        }
    }

    function fetchFromCache( $limit, $offset = false ) {
        $dbr = wfGetDB( DB_SLAVE );
        $options = array();
        if ( $limit !== false ) {
            $options['LIMIT'] = intval( $limit );
        }
        if ( $offset !== false ) {
            $options['OFFSET'] = intval( $offset );
        }
        if ( $this->sortDescending() ) {
            $options['ORDER BY'] = 'qc_value DESC';
        } else {
            $options['ORDER BY'] = 'qc_value ASC';
        }
        $res = $dbr->select( 'querycache', array( 'qc_type',
                'namespace' => 'qc_namespace',
                'title' => 'qc_title',
                'value' => 'qc_value' ),
                array( 'qc_type' => $this->getName() ),
                __METHOD__, $options
        );
        return $dbr->resultObject( $res );
    }

    public function getCachedTimestamp() {
        if ( is_null( $this->cachedTimestamp ) ) {
            $dbr = wfGetDB( DB_SLAVE );
            $fname = get_class( $this ) . '::getCachedTimestamp';
            $this->cachedTimestamp = $dbr->selectField( 'querycache_info', 'qci_timestamp',
                array( 'qci_type' => $this->getName() ), $fname );
        }
        return $this->cachedTimestamp;
    }

    function execute( $par ) {
        $user = $this->getUser();
        if ( !$this->userCanExecute( $user ) ) {
            $this->displayRestrictionError();
            return;
        }

        $this->setHeaders();
        $this->outputHeader();

        $out = $this->getOutput();

        if ( $this->isCached() && !$this->isCacheable() ) {
            $out->addWikiMsg( 'querypage-disabled' );
            return;
        }

        $out->setSyndicated( $this->isSyndicated() );

        if ( $this->limit == 0 && $this->offset == 0 ) {
            list( $this->limit, $this->offset ) = $this->getRequest()->getLimitOffset();
        }

        // @todo Use doQuery()
        if ( !$this->isCached() ) {
            # select one extra row for navigation
            $res = $this->reallyDoQuery( $this->limit + 1, $this->offset );
        } else {
            # Get the cached result, select one extra row for navigation
            $res = $this->fetchFromCache( $this->limit + 1, $this->offset );
            if ( !$this->listoutput ) {

                # Fetch the timestamp of this update
                $ts = $this->getCachedTimestamp();
                $lang = $this->getLanguage();
                $maxResults = $lang->formatNum( $this->getConfig()->get( 'QueryCacheLimit' ) );

                if ( $ts ) {
                    $updated = $lang->userTimeAndDate( $ts, $user );
                    $updateddate = $lang->userDate( $ts, $user );
                    $updatedtime = $lang->userTime( $ts, $user );
                    $out->addMeta( 'Data-Cache-Time', $ts );
                    $out->addJsConfigVars( 'dataCacheTime', $ts );
                    $out->addWikiMsg( 'perfcachedts', $updated, $updateddate, $updatedtime, $maxResults );
                } else {
                    $out->addWikiMsg( 'perfcached', $maxResults );
                }

                # If updates on this page have been disabled, let the user know
                # that the data set won't be refreshed for now
                if ( is_array( $this->getConfig()->get( 'DisableQueryPageUpdate' ) )
                    && in_array( $this->getName(), $this->getConfig()->get( 'DisableQueryPageUpdate' ) )
                ) {
                    $out->wrapWikiMsg(
                        "<div class=\"mw-querypage-no-updates\">\n$1\n</div>",
                        'querypage-no-updates'
                    );
                }
            }
        }

        $this->numRows = $res->numRows();

        $dbr = wfGetDB( DB_SLAVE );
        $this->preprocessResults( $dbr, $res );

        $out->addHTML( Xml::openElement( 'div', array( 'class' => 'mw-spcontent' ) ) );

        # Top header and navigation
        if ( $this->shownavigation ) {
            $out->addHTML( $this->getPageHeader() );
            if ( $this->numRows > 0 ) {
                $out->addHTML( $this->msg( 'showingresultsinrange' )->numParams(
                    min( $this->numRows, $this->limit ), # do not show the one extra row, if exist
                    $this->offset + 1, ( min( $this->numRows, $this->limit ) + $this->offset ) )->parseAsBlock() );
                # Disable the "next" link when we reach the end
                $paging = $this->getLanguage()->viewPrevNext( $this->getPageTitle( $par ), $this->offset,
                    $this->limit, $this->linkParameters(), ( $this->numRows <= $this->limit ) );
                $out->addHTML( '<p>' . $paging . '</p>' );
            } else {
                # No results to show, so don't bother with "showing X of Y" etc.
                # -- just let the user know and give up now
                $out->addWikiMsg( 'specialpage-empty' );
                $out->addHTML( Xml::closeElement( 'div' ) );
                return;
            }
        }

        # The actual results; specialist subclasses will want to handle this
        # with more than a straight list, so we hand them the info, plus
        # an OutputPage, and let them get on with it
        $this->outputResults( $out,
            $this->getSkin(),
            $dbr, # Should use a ResultWrapper for this
            $res,
            min( $this->numRows, $this->limit ), # do not format the one extra row, if exist
            $this->offset );

        # Repeat the paging links at the bottom
        if ( $this->shownavigation ) {
            $out->addHTML( '<p>' . $paging . '</p>' );
        }

        $out->addHTML( Xml::closeElement( 'div' ) );
    }

    protected function outputResults( $out, $skin, $dbr, $res, $num, $offset ) {
        global $wgContLang;

        if ( $num > 0 ) {
            $html = array();
            if ( !$this->listoutput ) {
                $html[] = $this->openList( $offset );
            }

            # $res might contain the whole 1,000 rows, so we read up to
            # $num [should update this to use a Pager]
            // @codingStandardsIgnoreStart Generic.CodeAnalysis.ForLoopWithTestFunctionCall.NotAllowed
            for ( $i = 0; $i < $num && $row = $res->fetchObject(); $i++ ) {
                // @codingStandardsIgnoreEnd
                $line = $this->formatResult( $skin, $row );
                if ( $line ) {
                    $attr = ( isset( $row->usepatrol ) && $row->usepatrol && $row->patrolled == 0 )
                        ? ' class="not-patrolled"'
                        : '';
                    $html[] = $this->listoutput
                        ? $line
                        : "<li{$attr}>{$line}</li>\n";
                }
            }

            # Flush the final result
            if ( $this->tryLastResult() ) {
                $row = null;
                $line = $this->formatResult( $skin, $row );
                if ( $line ) {
                    $attr = ( isset( $row->usepatrol ) && $row->usepatrol && $row->patrolled == 0 )
                        ? ' class="not-patrolled"'
                        : '';
                    $html[] = $this->listoutput
                        ? $line
                        : "<li{$attr}>{$line}</li>\n";
                }
            }

            if ( !$this->listoutput ) {
                $html[] = $this->closeList();
            }

            $html = $this->listoutput
                ? $wgContLang->listToText( $html )
                : implode( '', $html );

            $out->addHTML( $html );
        }
    }

    function openList( $offset ) {
        return "\n<ol start='" . ( $offset + 1 ) . "' class='special'>\n";
    }

    function closeList() {
        return "</ol>\n";
    }

    function preprocessResults( $db, $res ) {
    }

    function doFeed( $class = '', $limit = 50 ) {
        if ( !$this->getConfig()->get( 'Feed' ) ) {
            $this->getOutput()->addWikiMsg( 'feed-unavailable' );
            return false;
        }

        $limit = min( $limit, $this->getConfig()->get( 'FeedLimit' ) );

        $feedClasses = $this->getConfig()->get( 'FeedClasses' );
        if ( isset( $feedClasses[$class] ) ) {
            $feed = new $feedClasses[$class](
                $this->feedTitle(),
                $this->feedDesc(),
                $this->feedUrl() );
            $feed->outHeader();

            $res = $this->reallyDoQuery( $limit, 0 );
            foreach ( $res as $obj ) {
                $item = $this->feedResult( $obj );
                if ( $item ) {
                    $feed->outItem( $item );
                }
            }

            $feed->outFooter();
            return true;
        } else {
            return false;
        }
    }

    function feedResult( $row ) {
        if ( !isset( $row->title ) ) {
            return null;
        }
        $title = Title::makeTitle( intval( $row->namespace ), $row->title );
        if ( $title ) {
            $date = isset( $row->timestamp ) ? $row->timestamp : '';
            $comments = '';
            if ( $title ) {
                $talkpage = $title->getTalkPage();
                $comments = $talkpage->getFullURL();
            }

            return new FeedItem(
                $title->getPrefixedText(),
                $this->feedItemDesc( $row ),
                $title->getFullURL(),
                $date,
                $this->feedItemAuthor( $row ),
                $comments );
        } else {
            return null;
        }
    }

    function feedItemDesc( $row ) {
        return isset( $row->comment ) ? htmlspecialchars( $row->comment ) : '';
    }

    function feedItemAuthor( $row ) {
        return isset( $row->user_text ) ? $row->user_text : '';
    }

    function feedTitle() {
        $desc = $this->getDescription();
        $code = $this->getConfig()->get( 'LanguageCode' );
        $sitename = $this->getConfig()->get( 'Sitename' );
        return "$sitename - $desc [$code]";
    }

    function feedDesc() {
        return $this->msg( 'tagline' )->text();
    }

    function feedUrl() {
        return $this->getPageTitle()->getFullURL();
    }
}