LogPager.php

Go to the documentation of this file.

<?php
class LogPager extends ReverseChronologicalPager {
    private $types = [];

    private $performer = '';

    private $title = '';

    private $pattern = false;

    private $typeCGI = '';

    private $action = '';

    private $performerRestrictionsEnforced = false;

    private $actionRestrictionsEnforced = false;

    public $mLogEventsList;

    public function __construct( $list, $types = [], $performer = '', $title = '',
        $pattern = false, $conds = [], $year = false, $month = false, $day = false,
        $tagFilter = '', $action = '', $logId = 0
    ) {
        parent::__construct( $list->getContext() );
        $this->mConds = $conds;

        $this->mLogEventsList = $list;

        $this->limitType( $types ); // also excludes hidden types
        $this->limitPerformer( $performer );
        $this->limitTitle( $title, $pattern );
        $this->limitAction( $action );
        $this->getDateCond( $year, $month, $day );
        $this->mTagFilter = $tagFilter;
        $this->limitLogId( $logId );

        $this->mDb = wfGetDB( DB_REPLICA, 'logpager' );
    }

    public function getDefaultQuery() {
        $query = parent::getDefaultQuery();
        $query['type'] = $this->typeCGI; // arrays won't work here
        $query['user'] = $this->performer;
        $query['day'] = $this->mDay;
        $query['month'] = $this->mMonth;
        $query['year'] = $this->mYear;

        return $query;
    }

    // Call ONLY after calling $this->limitType() already!
    public function getFilterParams() {
        global $wgFilterLogTypes;
        $filters = [];
        if ( count( $this->types ) ) {
            return $filters;
        }

        $wpfilters = $this->getRequest()->getArray( "wpfilters" );
        $request_filters = $wpfilters === null ? [] : $wpfilters;

        foreach ( $wgFilterLogTypes as $type => $default ) {
            $hide = !in_array( $type, $request_filters );

            // Back-compat: Check old URL params if the new param wasn't passed
            if ( $wpfilters === null ) {
                $hide = $this->getRequest()->getBool( "hide_{$type}_log", $default );
            }

            $filters[$type] = $hide;
            if ( $hide ) {
                $this->mConds[] = 'log_type != ' . $this->mDb->addQuotes( $type );
            }
        }

        return $filters;
    }

    private function limitType( $types ) {
        global $wgLogRestrictions;

        $user = $this->getUser();
        // If $types is not an array, make it an array
        $types = ( $types === '' ) ? [] : (array)$types;
        // Don't even show header for private logs; don't recognize it...
        $needReindex = false;
        foreach ( $types as $type ) {
            if ( isset( $wgLogRestrictions[$type] )
                && !$user->isAllowed( $wgLogRestrictions[$type] )
            ) {
                $needReindex = true;
                $types = array_diff( $types, [ $type ] );
            }
        }
        if ( $needReindex ) {
            // Lots of this code makes assumptions that
            // the first entry in the array is $types[0].
            $types = array_values( $types );
        }
        $this->types = $types;
        // Don't show private logs to unprivileged users.
        // Also, only show them upon specific request to avoid suprises.
        $audience = $types ? 'user' : 'public';
        $hideLogs = LogEventsList::getExcludeClause( $this->mDb, $audience, $user );
        if ( $hideLogs !== false ) {
            $this->mConds[] = $hideLogs;
        }
        if ( count( $types ) ) {
            $this->mConds['log_type'] = $types;
            // Set typeCGI; used in url param for paging
            if ( count( $types ) == 1 ) {
                $this->typeCGI = $types[0];
            }
        }
    }

    private function limitPerformer( $name ) {
        if ( $name == '' ) {
            return;
        }
        $usertitle = Title::makeTitleSafe( NS_USER, $name );
        if ( is_null( $usertitle ) ) {
            return;
        }
        // Normalize username first so that non-existent users used
        // in maintenance scripts work
        $name = $usertitle->getText();

        // Assume no joins required for log_user
        $this->mConds[] = ActorMigration::newMigration()->getWhere(
            wfGetDB( DB_REPLICA ), 'log_user', User::newFromName( $name, false )
        )['conds'];

        $this->enforcePerformerRestrictions();

        $this->performer = $name;
    }

    private function limitTitle( $page, $pattern ) {
        global $wgMiserMode, $wgUserrightsInterwikiDelimiter;

        if ( $page instanceof Title ) {
            $title = $page;
        } else {
            $title = Title::newFromText( $page );
            if ( strlen( $page ) == 0 || !$title instanceof Title ) {
                return;
            }
        }

        $this->title = $title->getPrefixedText();
        $ns = $title->getNamespace();
        $db = $this->mDb;

        $doUserRightsLogLike = false;
        if ( $this->types == [ 'rights' ] ) {
            $parts = explode( $wgUserrightsInterwikiDelimiter, $title->getDBkey() );
            if ( count( $parts ) == 2 ) {
                list( $name, $database ) = array_map( 'trim', $parts );
                if ( strstr( $database, '*' ) ) { // Search for wildcard in database name
                    $doUserRightsLogLike = true;
                }
            }
        }

        $this->mConds['log_namespace'] = $ns;
        if ( $doUserRightsLogLike ) {
            $params = [ $name . $wgUserrightsInterwikiDelimiter ];
            foreach ( explode( '*', $database ) as $databasepart ) {
                $params[] = $databasepart;
                $params[] = $db->anyString();
            }
            array_pop( $params ); // Get rid of the last % we added.
            $this->mConds[] = 'log_title' . $db->buildLike( $params );
        } elseif ( $pattern && !$wgMiserMode ) {
            $this->mConds[] = 'log_title' . $db->buildLike( $title->getDBkey(), $db->anyString() );
            $this->pattern = $pattern;
        } else {
            $this->mConds['log_title'] = $title->getDBkey();
        }
        $this->enforceActionRestrictions();
    }

    private function limitAction( $action ) {
        global $wgActionFilteredLogs;
        // Allow to filter the log by actions
        $type = $this->typeCGI;
        if ( $type === '' ) {
            // nothing to do
            return;
        }
        $actions = $wgActionFilteredLogs;
        if ( isset( $actions[$type] ) ) {
            // log type can be filtered by actions
            $this->mLogEventsList->setAllowedActions( array_keys( $actions[$type] ) );
            if ( $action !== '' && isset( $actions[$type][$action] ) ) {
                // add condition to query
                $this->mConds['log_action'] = $actions[$type][$action];
                $this->action = $action;
            }
        }
    }

    protected function limitLogId( $logId ) {
        if ( !$logId ) {
            return;
        }
        $this->mConds['log_id'] = $logId;
    }

    public function getQueryInfo() {
        $basic = DatabaseLogEntry::getSelectQueryData();

        $tables = $basic['tables'];
        $fields = $basic['fields'];
        $conds = $basic['conds'];
        $options = $basic['options'];
        $joins = $basic['join_conds'];

        # Add log_search table if there are conditions on it.
        # This filters the results to only include log rows that have
        # log_search records with the specified ls_field and ls_value values.
        if ( array_key_exists( 'ls_field', $this->mConds ) ) {
            $tables[] = 'log_search';
            $options['IGNORE INDEX'] = [ 'log_search' => 'ls_log_id' ];
            $options['USE INDEX'] = [ 'logging' => 'PRIMARY' ];
            if ( !$this->hasEqualsClause( 'ls_field' )
                || !$this->hasEqualsClause( 'ls_value' )
            ) {
                # Since (ls_field,ls_value,ls_logid) is unique, if the condition is
                # to match a specific (ls_field,ls_value) tuple, then there will be
                # no duplicate log rows. Otherwise, we need to remove the duplicates.
                $options[] = 'DISTINCT';
            }
        }
        # Don't show duplicate rows when using log_search
        $joins['log_search'] = [ 'JOIN', 'ls_log_id=log_id' ];

        // T221458: MySQL/MariaDB (10.1.37) can sometimes irrationally decide that querying `actor` before
        // `logging` and filesorting is somehow better than querying $limit+1 rows from `logging`.
        // Tell it not to reorder the query. But not when tag filtering or log_search was used, as it
        // seems as likely to be harmed as helped in that case.
        if ( !$this->mTagFilter && !array_key_exists( 'ls_field', $this->mConds ) ) {
            $options[] = 'STRAIGHT_JOIN';
        }

        $info = [
            'tables' => $tables,
            'fields' => $fields,
            'conds' => array_merge( $conds, $this->mConds ),
            'options' => $options,
            'join_conds' => $joins,
        ];
        # Add ChangeTags filter query
        ChangeTags::modifyDisplayQuery( $info['tables'], $info['fields'], $info['conds'],
            $info['join_conds'], $info['options'], $this->mTagFilter );

        return $info;
    }

    protected function hasEqualsClause( $field ) {
        return (
            array_key_exists( $field, $this->mConds ) &&
            ( !is_array( $this->mConds[$field] ) || count( $this->mConds[$field] ) == 1 )
        );
    }

    function getIndexField() {
        return 'log_timestamp';
    }

    protected function getStartBody() {
        # Do a link batch query
        if ( $this->getNumRows() > 0 ) {
            $lb = new LinkBatch;
            foreach ( $this->mResult as $row ) {
                $lb->add( $row->log_namespace, $row->log_title );
                $lb->addObj( Title::makeTitleSafe( NS_USER, $row->user_name ) );
                $lb->addObj( Title::makeTitleSafe( NS_USER_TALK, $row->user_name ) );
                $formatter = LogFormatter::newFromRow( $row );
                foreach ( $formatter->getPreloadTitles() as $title ) {
                    $lb->addObj( $title );
                }
            }
            $lb->execute();
            $this->mResult->seek( 0 );
        }

        return '';
    }

    public function formatRow( $row ) {
        return $this->mLogEventsList->logLine( $row );
    }

    public function getType() {
        return $this->types;
    }

    public function getPerformer() {
        return $this->performer;
    }

    public function getPage() {
        return $this->title;
    }

    public function getPattern() {
        return $this->pattern;
    }

    public function getYear() {
        return $this->mYear;
    }

    public function getMonth() {
        return $this->mMonth;
    }

    public function getDay() {
        return $this->mDay;
    }

    public function getTagFilter() {
        return $this->mTagFilter;
    }

    public function getAction() {
        return $this->action;
    }

    public function doQuery() {
        // Workaround MySQL optimizer bug
        $this->mDb->setBigSelects();
        parent::doQuery();
        $this->mDb->setBigSelects( 'default' );
    }

    private function enforceActionRestrictions() {
        if ( $this->actionRestrictionsEnforced ) {
            return;
        }
        $this->actionRestrictionsEnforced = true;
        $user = $this->getUser();
        if ( !$user->isAllowed( 'deletedhistory' ) ) {
            $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::DELETED_ACTION ) . ' = 0';
        } elseif ( !$user->isAllowedAny( 'suppressrevision', 'viewsuppressed' ) ) {
            $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::SUPPRESSED_ACTION ) .
                ' != ' . LogPage::SUPPRESSED_USER;
        }
    }

    private function enforcePerformerRestrictions() {
        // Same as enforceActionRestrictions(), except for _USER instead of _ACTION bits.
        if ( $this->performerRestrictionsEnforced ) {
            return;
        }
        $this->performerRestrictionsEnforced = true;
        $user = $this->getUser();
        if ( !$user->isAllowed( 'deletedhistory' ) ) {
            $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::DELETED_USER ) . ' = 0';
        } elseif ( !$user->isAllowedAny( 'suppressrevision', 'viewsuppressed' ) ) {
            $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::SUPPRESSED_USER ) .
                ' != ' . LogPage::SUPPRESSED_ACTION;
        }
    }
}