includes/logging/LogPager.php

   1 <?php
   2 /**
   3  * Contain classes to list log entries
   4  *
   5  * Copyright © 2004 Brion Vibber <brion@pobox.com>
   6  * https://www.mediawiki.org/
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License along
  19  * with this program; if not, write to the Free Software Foundation, Inc.,
  20  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  21  * http://www.gnu.org/copyleft/gpl.html
  22  *
  23  * @file
  24  */
  25
  26 /**
  27  * @ingroup Pager
  28  */
  29 class LogPager extends ReverseChronologicalPager {
  30         /** @var array Log types */
  31         private $types = [];
  32
  33         /** @var string Events limited to those by performer when set */
  34         private $performer = '';
  35
  36         /** @var string|Title Events limited to those about Title when set */
  37         private $title = '';
  38
  39         /** @var string */
  40         private $pattern = '';
  41
  42         /** @var string */
  43         private $typeCGI = '';
  44
  45         /** @var string */
  46         private $action = '';
  47
  48         /** @var bool */
  49         private $performerRestrictionsEnforced = false;
  50
  51         /** @var bool */
  52         private $actionRestrictionsEnforced = false;
  53
  54         /** @var LogEventsList */
  55         public $mLogEventsList;
  56
  57         /**
  58          * @param LogEventsList $list
  59          * @param string|array $types Log types to show
  60          * @param string $performer The user who made the log entries
  61          * @param string|Title $title The page title the log entries are for
  62          * @param string $pattern Do a prefix search rather than an exact title match
  63          * @param array $conds Extra conditions for the query
  64          * @param int|bool $year The year to start from. Default: false
  65          * @param int|bool $month The month to start from. Default: false
  66          * @param string $tagFilter Tag
  67          * @param string $action Specific action (subtype) requested
  68          */
  69         public function __construct( $list, $types = [], $performer = '', $title = '',
  70                 $pattern = '', $conds = [], $year = false, $month = false, $tagFilter = '',
  71                 $action = ''
  72         ) {
  73                 parent::__construct( $list->getContext() );
  74                 $this->mConds = $conds;
  75
  76                 $this->mLogEventsList = $list;
  77
  78                 $this->limitType( $types ); // also excludes hidden types
  79                 $this->limitPerformer( $performer );
  80                 $this->limitTitle( $title, $pattern );
  81                 $this->limitAction( $action );
  82                 $this->getDateCond( $year, $month );
  83                 $this->mTagFilter = $tagFilter;
  84
  85                 $this->mDb = wfGetDB( DB_REPLICA, 'logpager' );
  86         }
  87
  88         public function getDefaultQuery() {
  89                 $query = parent::getDefaultQuery();
  90                 $query['type'] = $this->typeCGI; // arrays won't work here
  91                 $query['user'] = $this->performer;
  92                 $query['month'] = $this->mMonth;
  93                 $query['year'] = $this->mYear;
  94
  95                 return $query;
  96         }
  97
  98         // Call ONLY after calling $this->limitType() already!
  99         public function getFilterParams() {
 100                 global $wgFilterLogTypes;
 101                 $filters = [];
 102                 if ( count( $this->types ) ) {
 103                         return $filters;
 104                 }
 105                 foreach ( $wgFilterLogTypes as $type => $default ) {
 106                         $hide = $this->getRequest()->getInt( "hide_{$type}_log", $default );
 107
 108                         $filters[$type] = $hide;
 109                         if ( $hide ) {
 110                                 $this->mConds[] = 'log_type != ' . $this->mDb->addQuotes( $type );
 111                         }
 112                 }
 113
 114                 return $filters;
 115         }
 116
 117         /**
 118          * Set the log reader to return only entries of the given type.
 119          * Type restrictions enforced here
 120          *
 121          * @param string|array $types Log types ('upload', 'delete', etc);
 122          *   empty string means no restriction
 123          */
 124         private function limitType( $types ) {
 125                 global $wgLogRestrictions;
 126
 127                 $user = $this->getUser();
 128                 // If $types is not an array, make it an array
 129                 $types = ( $types === '' ) ? [] : (array)$types;
 130                 // Don't even show header for private logs; don't recognize it...
 131                 $needReindex = false;
 132                 foreach ( $types as $type ) {
 133                         if ( isset( $wgLogRestrictions[$type] )
 134                                 && !$user->isAllowed( $wgLogRestrictions[$type] )
 135                         ) {
 136                                 $needReindex = true;
 137                                 $types = array_diff( $types, [ $type ] );
 138                         }
 139                 }
 140                 if ( $needReindex ) {
 141                         // Lots of this code makes assumptions that
 142                         // the first entry in the array is $types[0].
 143                         $types = array_values( $types );
 144                 }
 145                 $this->types = $types;
 146                 // Don't show private logs to unprivileged users.
 147                 // Also, only show them upon specific request to avoid suprises.
 148                 $audience = $types ? 'user' : 'public';
 149                 $hideLogs = LogEventsList::getExcludeClause( $this->mDb, $audience, $user );
 150                 if ( $hideLogs !== false ) {
 151                         $this->mConds[] = $hideLogs;
 152                 }
 153                 if ( count( $types ) ) {
 154                         $this->mConds['log_type'] = $types;
 155                         // Set typeCGI; used in url param for paging
 156                         if ( count( $types ) == 1 ) {
 157                                 $this->typeCGI = $types[0];
 158                         }
 159                 }
 160         }
 161
 162         /**
 163          * Set the log reader to return only entries by the given user.
 164          *
 165          * @param string $name (In)valid user name
 166          * @return void
 167          */
 168         private function limitPerformer( $name ) {
 169                 if ( $name == '' ) {
 170                         return;
 171                 }
 172                 $usertitle = Title::makeTitleSafe( NS_USER, $name );
 173                 if ( is_null( $usertitle ) ) {
 174                         return;
 175                 }
 176                 // Normalize username first so that non-existent users used
 177                 // in maintenance scripts work
 178                 $name = $usertitle->getText();
 179
 180                 // Assume no joins required for log_user
 181                 // Don't query by user ID here, it might be able to use the
 182                 // log_user_text_time or log_user_text_type_time index.
 183                 $this->mConds[] = ActorMigration::newMigration()->getWhere(
 184                         wfGetDB( DB_REPLICA ), 'log_user', User::newFromName( $name, false ), false
 185                 )['conds'];
 186
 187                 $this->enforcePerformerRestrictions();
 188
 189                 $this->performer = $name;
 190         }
 191
 192         /**
 193          * Set the log reader to return only entries affecting the given page.
 194          * (For the block and rights logs, this is a user page.)
 195          *
 196          * @param string|Title $page Title name
 197          * @param string $pattern
 198          * @return void
 199          */
 200         private function limitTitle( $page, $pattern ) {
 201                 global $wgMiserMode, $wgUserrightsInterwikiDelimiter;
 202
 203                 if ( $page instanceof Title ) {
 204                         $title = $page;
 205                 } else {
 206                         $title = Title::newFromText( $page );
 207                         if ( strlen( $page ) == 0 || !$title instanceof Title ) {
 208                                 return;
 209                         }
 210                 }
 211
 212                 $this->title = $title->getPrefixedText();
 213                 $ns = $title->getNamespace();
 214                 $db = $this->mDb;
 215
 216                 $doUserRightsLogLike = false;
 217                 if ( $this->types == [ 'rights' ] ) {
 218                         $parts = explode( $wgUserrightsInterwikiDelimiter, $title->getDBkey() );
 219                         if ( count( $parts ) == 2 ) {
 220                                 list( $name, $database ) = array_map( 'trim', $parts );
 221                                 if ( strstr( $database, '*' ) ) { // Search for wildcard in database name
 222                                         $doUserRightsLogLike = true;
 223                                 }
 224                         }
 225                 }
 226
 227                 /**
 228                  * Using the (log_namespace, log_title, log_timestamp) index with a
 229                  * range scan (LIKE) on the first two parts, instead of simple equality,
 230                  * makes it unusable for sorting.  Sorted retrieval using another index
 231                  * would be possible, but then we might have to scan arbitrarily many
 232                  * nodes of that index. Therefore, we need to avoid this if $wgMiserMode
 233                  * is on.
 234                  *
 235                  * This is not a problem with simple title matches, because then we can
 236                  * use the page_time index.  That should have no more than a few hundred
 237                  * log entries for even the busiest pages, so it can be safely scanned
 238                  * in full to satisfy an impossible condition on user or similar.
 239                  */
 240                 $this->mConds['log_namespace'] = $ns;
 241                 if ( $doUserRightsLogLike ) {
 242                         $params = [ $name . $wgUserrightsInterwikiDelimiter ];
 243                         foreach ( explode( '*', $database ) as $databasepart ) {
 244                                 $params[] = $databasepart;
 245                                 $params[] = $db->anyString();
 246                         }
 247                         array_pop( $params ); // Get rid of the last % we added.
 248                         $this->mConds[] = 'log_title' . $db->buildLike( $params );
 249                 } elseif ( $pattern && !$wgMiserMode ) {
 250                         $this->mConds[] = 'log_title' . $db->buildLike( $title->getDBkey(), $db->anyString() );
 251                         $this->pattern = $pattern;
 252                 } else {
 253                         $this->mConds['log_title'] = $title->getDBkey();
 254                 }
 255                 $this->enforceActionRestrictions();
 256         }
 257
 258         /**
 259          * Set the log_action field to a specified value (or values)
 260          *
 261          * @param string $action
 262          */
 263         private function limitAction( $action ) {
 264                 global $wgActionFilteredLogs;
 265                 // Allow to filter the log by actions
 266                 $type = $this->typeCGI;
 267                 if ( $type === '' ) {
 268                         // nothing to do
 269                         return;
 270                 }
 271                 $actions = $wgActionFilteredLogs;
 272                 if ( isset( $actions[$type] ) ) {
 273                         // log type can be filtered by actions
 274                         $this->mLogEventsList->setAllowedActions( array_keys( $actions[$type] ) );
 275                         if ( $action !== '' && isset( $actions[$type][$action] ) ) {
 276                                 // add condition to query
 277                                 $this->mConds['log_action'] = $actions[$type][$action];
 278                                 $this->action = $action;
 279                         }
 280                 }
 281         }
 282
 283         /**
 284          * Constructs the most part of the query. Extra conditions are sprinkled in
 285          * all over this class.
 286          * @return array
 287          */
 288         public function getQueryInfo() {
 289                 $basic = DatabaseLogEntry::getSelectQueryData();
 290
 291                 $tables = $basic['tables'];
 292                 $fields = $basic['fields'];
 293                 $conds = $basic['conds'];
 294                 $options = $basic['options'];
 295                 $joins = $basic['join_conds'];
 296
 297                 # Add log_search table if there are conditions on it.
 298                 # This filters the results to only include log rows that have
 299                 # log_search records with the specified ls_field and ls_value values.
 300                 if ( array_key_exists( 'ls_field', $this->mConds ) ) {
 301                         $tables[] = 'log_search';
 302                         $options['IGNORE INDEX'] = [ 'log_search' => 'ls_log_id' ];
 303                         $options['USE INDEX'] = [ 'logging' => 'PRIMARY' ];
 304                         if ( !$this->hasEqualsClause( 'ls_field' )
 305                                 || !$this->hasEqualsClause( 'ls_value' )
 306                         ) {
 307                                 # Since (ls_field,ls_value,ls_logid) is unique, if the condition is
 308                                 # to match a specific (ls_field,ls_value) tuple, then there will be
 309                                 # no duplicate log rows. Otherwise, we need to remove the duplicates.
 310                                 $options[] = 'DISTINCT';
 311                         }
 312                 }
 313                 # Don't show duplicate rows when using log_search
 314                 $joins['log_search'] = [ 'INNER JOIN', 'ls_log_id=log_id' ];
 315
 316                 $info = [
 317                         'tables' => $tables,
 318                         'fields' => $fields,
 319                         'conds' => array_merge( $conds, $this->mConds ),
 320                         'options' => $options,
 321                         'join_conds' => $joins,
 322                 ];
 323                 # Add ChangeTags filter query
 324                 ChangeTags::modifyDisplayQuery( $info['tables'], $info['fields'], $info['conds'],
 325                         $info['join_conds'], $info['options'], $this->mTagFilter );
 326
 327                 return $info;
 328         }
 329
 330         /**
 331          * Checks if $this->mConds has $field matched to a *single* value
 332          * @param string $field
 333          * @return bool
 334          */
 335         protected function hasEqualsClause( $field ) {
 336                 return (
 337                         array_key_exists( $field, $this->mConds ) &&
 338                         ( !is_array( $this->mConds[$field] ) || count( $this->mConds[$field] ) == 1 )
 339                 );
 340         }
 341
 342         function getIndexField() {
 343                 return 'log_timestamp';
 344         }
 345
 346         public function getStartBody() {
 347                 # Do a link batch query
 348                 if ( $this->getNumRows() > 0 ) {
 349                         $lb = new LinkBatch;
 350                         foreach ( $this->mResult as $row ) {
 351                                 $lb->add( $row->log_namespace, $row->log_title );
 352                                 $lb->addObj( Title::makeTitleSafe( NS_USER, $row->user_name ) );
 353                                 $lb->addObj( Title::makeTitleSafe( NS_USER_TALK, $row->user_name ) );
 354                                 $formatter = LogFormatter::newFromRow( $row );
 355                                 foreach ( $formatter->getPreloadTitles() as $title ) {
 356                                         $lb->addObj( $title );
 357                                 }
 358                         }
 359                         $lb->execute();
 360                         $this->mResult->seek( 0 );
 361                 }
 362
 363                 return '';
 364         }
 365
 366         public function formatRow( $row ) {
 367                 return $this->mLogEventsList->logLine( $row );
 368         }
 369
 370         public function getType() {
 371                 return $this->types;
 372         }
 373
 374         /**
 375          * Guaranteed to either return a valid title string or a Zero-Length String
 376          *
 377          * @return string
 378          */
 379         public function getPerformer() {
 380                 return $this->performer;
 381         }
 382
 383         /**
 384          * @return string
 385          */
 386         public function getPage() {
 387                 return $this->title;
 388         }
 389
 390         public function getPattern() {
 391                 return $this->pattern;
 392         }
 393
 394         public function getYear() {
 395                 return $this->mYear;
 396         }
 397
 398         public function getMonth() {
 399                 return $this->mMonth;
 400         }
 401
 402         public function getTagFilter() {
 403                 return $this->mTagFilter;
 404         }
 405
 406         public function getAction() {
 407                 return $this->action;
 408         }
 409
 410         public function doQuery() {
 411                 // Workaround MySQL optimizer bug
 412                 $this->mDb->setBigSelects();
 413                 parent::doQuery();
 414                 $this->mDb->setBigSelects( 'default' );
 415         }
 416
 417         /**
 418          * Paranoia: avoid brute force searches (T19342)
 419          */
 420         private function enforceActionRestrictions() {
 421                 if ( $this->actionRestrictionsEnforced ) {
 422                         return;
 423                 }
 424                 $this->actionRestrictionsEnforced = true;
 425                 $user = $this->getUser();
 426                 if ( !$user->isAllowed( 'deletedhistory' ) ) {
 427                         $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::DELETED_USER ) . ' = 0';
 428                 } elseif ( !$user->isAllowedAny( 'suppressrevision', 'viewsuppressed' ) ) {
 429                         $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::SUPPRESSED_USER ) .
 430                                 ' != ' . LogPage::SUPPRESSED_USER;
 431                 }
 432         }
 433
 434         /**
 435          * Paranoia: avoid brute force searches (T19342)
 436          */
 437         private function enforcePerformerRestrictions() {
 438                 // Same as enforceActionRestrictions(), except for _USER instead of _ACTION bits.
 439                 if ( $this->performerRestrictionsEnforced ) {
 440                         return;
 441                 }
 442                 $this->performerRestrictionsEnforced = true;
 443                 $user = $this->getUser();
 444                 if ( !$user->isAllowed( 'deletedhistory' ) ) {
 445                         $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::DELETED_ACTION ) . ' = 0';
 446                 } elseif ( !$user->isAllowedAny( 'suppressrevision', 'viewsuppressed' ) ) {
 447                         $this->mConds[] = $this->mDb->bitAnd( 'log_deleted', LogPage::SUPPRESSED_ACTION ) .
 448                                 ' != ' . LogPage::SUPPRESSED_ACTION;
 449                 }
 450         }
 451 }