fields to be updated * * @var array * @access private */ var $tables; /** * Flag that can be set to false, in case another process has already started * the updates and the old username may have already been renamed in the user table. * * @var bool * @access private */ var $checkIfUserExists; /** * Constructor * * @param $old string The old username * @param $new string The new username * @param $uid * @param $options Array of options * 'checkIfUserExists' - bool, whether to update the user table */ function __construct( $old, $new, $uid, $options = array() ) { $this->old = $old; $this->new = $new; $this->uid = $uid; $this->checkIfUserExists = true; if ( isset ( $options['checkIfUserExists'] ) ) { $this->checkIfUserExists = $options['checkIfUserExists']; } $this->tables = array(); // Immediate updates $this->tables['image'] = array( 'img_user_text', 'img_user' ); $this->tables['oldimage'] = array( 'oi_user_text', 'oi_user' ); $this->tables['filearchive'] = array('fa_user_text','fa_user'); $this->tablesJob = array(); // Slow updates // If this user has a large number of edits, use the jobqueue if ( User::newFromId( $uid )->getEditCount() > RENAMEUSER_CONTRIBJOB ) { $this->tablesJob['revision'] = array( 'rev_user_text', 'rev_user', 'rev_timestamp' ); $this->tablesJob['archive'] = array( 'ar_user_text', 'ar_user', 'ar_timestamp' ); $this->tablesJob['logging'] = array( 'log_user_text', 'log_user', 'log_timestamp' ); } else { $this->tables['revision'] = array( 'rev_user_text', 'rev_user' ); $this->tables['archive'] = array( 'ar_user_text', 'ar_user' ); $this->tables['logging'] = array( 'log_user_text', 'log_user' ); } // Recent changes is pretty hot, deadlocks occur if done all at once if ( wfQueriesMustScale() ) { $this->tablesJob['recentchanges'] = array( 'rc_user_text', 'rc_user', 'rc_timestamp' ); } else { $this->tables['recentchanges'] = array( 'rc_user_text', 'rc_user' ); } wfRunHooks( 'RenameUserSQL', array( $this ) ); } /** * Do the rename operation */ function rename() { global $wgMemc, $wgAuth, $wgUpdateRowsPerJob; wfProfileIn( __METHOD__ ); $dbw = wfGetDB( DB_MASTER ); $dbw->begin(); wfRunHooks( 'RenameUserPreRename', array( $this->uid, $this->old, $this->new ) ); // Rename and touch the user before re-attributing edits, // this avoids users still being logged in and making new edits while // being renamed, which leaves edits at the old name. $dbw->update( 'user', array( 'user_name' => $this->new, 'user_touched' => $dbw->timestamp() ), array( 'user_name' => $this->old, 'user_id' => $this->uid ), __METHOD__ ); if ( !$dbw->affectedRows() && $this->checkIfUserExists ) { $dbw->rollback(); return false; } // Reset token to break login with central auth systems. // Again, avoids user being logged in with old name. $user = User::newFromId( $this->uid ); $authUser = $wgAuth->getUserInstance( $user ); $authUser->resetAuthToken(); // Delete from memcached. $wgMemc->delete( wfMemcKey( 'user', 'id', $this->uid ) ); // Update ipblock list if this user has a block in there. $dbw->update( 'ipblocks', array( 'ipb_address' => $this->new ), array( 'ipb_user' => $this->uid, 'ipb_address' => $this->old ), __METHOD__ ); // Update this users block/rights log. Ideally, the logs would be historical, // but it is really annoying when users have "clean" block logs by virtue of // being renamed, which makes admin tasks more of a pain... $oldTitle = Title::makeTitle( NS_USER, $this->old ); $newTitle = Title::makeTitle( NS_USER, $this->new ); $dbw->update( 'logging', array( 'log_title' => $newTitle->getDBkey() ), array( 'log_type' => array( 'block', 'rights' ), 'log_namespace' => NS_USER, 'log_title' => $oldTitle->getDBkey() ), __METHOD__ ); // Do immediate updates! foreach ( $this->tables as $table => $fieldSet ) { list( $nameCol, $userCol ) = $fieldSet; $dbw->update( $table, array( $nameCol => $this->new ), array( $nameCol => $this->old, $userCol => $this->uid ), __METHOD__ ); } // Increase time limit (like CheckUser); this can take a while... if ( $this->tablesJob ) { wfSuppressWarnings(); set_time_limit( 120 ); wfRestoreWarnings(); } $jobs = array(); // jobs for all tables // Construct jobqueue updates... // FIXME: if a bureaucrat renames a user in error, he/she // must be careful to wait until the rename finishes before // renaming back. This is due to the fact the the job "queue" // is not really FIFO, so we might end up with a bunch of edits // randomly mixed between the two new names. Some sort of rename // lock might be in order... foreach ( $this->tablesJob as $table => $params ) { $userTextC = $params[0]; // some *_user_text column $userIDC = $params[1]; // some *_user column $timestampC = $params[2]; // some *_timestamp column $res = $dbw->select( $table, array( $timestampC ), array( $userTextC => $this->old, $userIDC => $this->uid ), __METHOD__, array( 'ORDER BY' => "$timestampC ASC" ) ); $jobParams = array(); $jobParams['table'] = $table; $jobParams['column'] = $userTextC; $jobParams['uidColumn'] = $userIDC; $jobParams['timestampColumn'] = $timestampC; $jobParams['oldname'] = $this->old; $jobParams['newname'] = $this->new; $jobParams['userID'] = $this->uid; // Timestamp column data for index optimizations $jobParams['minTimestamp'] = '0'; $jobParams['maxTimestamp'] = '0'; $jobParams['count'] = 0; // Insert jobs into queue! while ( true ) { $row = $dbw->fetchObject( $res ); if ( !$row ) { # If there are any job rows left, add it to the queue as one job if ( $jobParams['count'] > 0 ) { $jobs[] = Job::factory( 'renameUser', $oldTitle, $jobParams ); } break; } # Since the ORDER BY is ASC, set the min timestamp with first row if ( $jobParams['count'] == 0 ) { $jobParams['minTimestamp'] = $row->$timestampC; } # Keep updating the last timestamp, so it should be correct # when the last item is added. $jobParams['maxTimestamp'] = $row->$timestampC; # Update row counter $jobParams['count']++; # Once a job has $wgUpdateRowsPerJob rows, add it to the queue if ( $jobParams['count'] >= $wgUpdateRowsPerJob ) { $jobs[] = Job::factory( 'renameUser', $oldTitle, $jobParams ); $jobParams['minTimestamp'] = '0'; $jobParams['maxTimestamp'] = '0'; $jobParams['count'] = 0; } } $dbw->freeResult( $res ); } if ( count( $jobs ) > 0 ) { JobQueueGroup::singleton()->push( $jobs, JobQueue::QOS_ATOMIC ); // don't commit yet } // Commit the transaction $dbw->commit(); // Delete from memcached again to make sure $wgMemc->delete( wfMemcKey( 'user', 'id', $this->uid ) ); // Clear caches and inform authentication plugins $user = User::newFromId( $this->uid ); $wgAuth->updateExternalDB( $user ); wfRunHooks( 'RenameUserComplete', array( $this->uid, $this->old, $this->new ) ); wfProfileOut( __METHOD__ ); return true; } }