2023-03-06 01:16:39 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
use MediaWiki\Page\MovePageFactory;
|
|
|
|
|
use MediaWiki\RenameUser\RenameuserSQL;
|
2023-08-25 12:29:41 +00:00
|
|
|
use MediaWiki\Status\Status;
|
2023-03-06 01:16:39 +00:00
|
|
|
use MediaWiki\Title\TitleFactory;
|
|
|
|
|
use MediaWiki\User\TempUser\Pattern;
|
2023-09-19 12:13:45 +00:00
|
|
|
use MediaWiki\User\User;
|
2023-03-06 01:16:39 +00:00
|
|
|
use MediaWiki\User\UserFactory;
|
2023-12-05 21:00:02 +00:00
|
|
|
use Wikimedia\Rdbms\IExpression;
|
2023-03-06 01:16:39 +00:00
|
|
|
|
2024-08-27 12:00:25 +00:00
|
|
|
// @codeCoverageIgnoreStart
|
2023-03-06 01:16:39 +00:00
|
|
|
require_once __DIR__ . '/Maintenance.php';
|
2024-08-27 12:00:25 +00:00
|
|
|
// @codeCoverageIgnoreEnd
|
2023-03-06 01:16:39 +00:00
|
|
|
|
|
|
|
|
class RenameUsersMatchingPattern extends Maintenance {
|
|
|
|
|
/** @var UserFactory */
|
|
|
|
|
private $userFactory;
|
|
|
|
|
|
|
|
|
|
/** @var MovePageFactory */
|
|
|
|
|
private $movePageFactory;
|
|
|
|
|
|
|
|
|
|
/** @var TitleFactory */
|
|
|
|
|
private $titleFactory;
|
|
|
|
|
|
|
|
|
|
/** @var User */
|
|
|
|
|
private $performer;
|
|
|
|
|
|
|
|
|
|
/** @var string */
|
|
|
|
|
private $reason;
|
|
|
|
|
|
|
|
|
|
/** @var bool */
|
|
|
|
|
private $dryRun;
|
|
|
|
|
|
|
|
|
|
/** @var bool */
|
|
|
|
|
private $suppressRedirect;
|
|
|
|
|
|
|
|
|
|
/** @var bool */
|
|
|
|
|
private $skipPageMoves;
|
|
|
|
|
|
|
|
|
|
public function __construct() {
|
|
|
|
|
parent::__construct();
|
|
|
|
|
|
|
|
|
|
$this->addDescription( 'Rename users with a name matching a pattern. ' .
|
|
|
|
|
'This can be used to migrate to a temporary user (IP masking) configuration.' );
|
|
|
|
|
$this->addOption( 'from', 'A username pattern where $1 is ' .
|
|
|
|
|
'the wildcard standing in for any number of characters. All users ' .
|
|
|
|
|
'matching this pattern will be renamed.', true, true );
|
|
|
|
|
$this->addOption( 'to', 'A username pattern where $1 is ' .
|
|
|
|
|
'the part of the username matched by $1 in --from. Users will be ' .
|
|
|
|
|
' renamed to this pattern.', true, true );
|
|
|
|
|
$this->addOption( 'performer', 'Performer of the rename action', false, true );
|
|
|
|
|
$this->addOption( 'reason', 'Reason of the rename', false, true );
|
|
|
|
|
$this->addOption( 'suppress-redirect', 'Don\'t create redirects when moving pages' );
|
|
|
|
|
$this->addOption( 'skip-page-moves', 'Don\'t move associated user pages' );
|
|
|
|
|
$this->addOption( 'dry-run', 'Don\'t actually rename the ' .
|
|
|
|
|
'users, just report what it would do.' );
|
|
|
|
|
$this->setBatchSize( 1000 );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private function initServices() {
|
2023-08-31 09:21:12 +00:00
|
|
|
$services = $this->getServiceContainer();
|
2023-03-06 01:16:39 +00:00
|
|
|
if ( $services->getCentralIdLookupFactory()->getNonLocalLookup() ) {
|
|
|
|
|
$this->fatalError( "This script cannot be run when CentralAuth is enabled." );
|
|
|
|
|
}
|
|
|
|
|
$this->userFactory = $services->getUserFactory();
|
|
|
|
|
$this->movePageFactory = $services->getMovePageFactory();
|
|
|
|
|
$this->titleFactory = $services->getTitleFactory();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function execute() {
|
|
|
|
|
$this->initServices();
|
|
|
|
|
|
|
|
|
|
$fromPattern = new Pattern( 'from', $this->getOption( 'from' ) );
|
|
|
|
|
$toPattern = new Pattern( 'to', $this->getOption( 'to' ) );
|
|
|
|
|
|
|
|
|
|
if ( $this->getOption( 'performer' ) === null ) {
|
|
|
|
|
$performer = User::newSystemUser( User::MAINTENANCE_SCRIPT_USER, [ 'steal' => true ] );
|
|
|
|
|
} else {
|
|
|
|
|
$performer = $this->userFactory->newFromName( $this->getOption( 'performer' ) );
|
|
|
|
|
}
|
|
|
|
|
if ( !$performer ) {
|
|
|
|
|
$this->error( "Unable to get performer account" );
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
$this->performer = $performer;
|
|
|
|
|
|
|
|
|
|
$this->reason = $this->getOption( 'reason', '' );
|
|
|
|
|
$this->dryRun = $this->getOption( 'dry-run' );
|
|
|
|
|
$this->suppressRedirect = $this->getOption( 'suppress-redirect' );
|
|
|
|
|
$this->skipPageMoves = $this->getOption( 'skip-page-moves' );
|
|
|
|
|
|
2024-01-17 18:53:40 +00:00
|
|
|
$dbr = $this->getReplicaDB();
|
2023-03-06 01:16:39 +00:00
|
|
|
$batchConds = [];
|
|
|
|
|
$batchSize = $this->getBatchSize();
|
|
|
|
|
$numRenamed = 0;
|
|
|
|
|
do {
|
|
|
|
|
$res = $dbr->newSelectQueryBuilder()
|
|
|
|
|
->select( [ 'user_name' ] )
|
|
|
|
|
->from( 'user' )
|
2023-12-05 21:00:02 +00:00
|
|
|
->where( $dbr->expr( 'user_name', IExpression::LIKE, $fromPattern->toLikeValue( $dbr ) ) )
|
2023-10-26 17:36:16 +00:00
|
|
|
->andWhere( $batchConds )
|
2023-03-06 01:16:39 +00:00
|
|
|
->orderBy( 'user_name' )
|
|
|
|
|
->limit( $batchSize )
|
|
|
|
|
->caller( __METHOD__ )
|
|
|
|
|
->fetchResultSet();
|
|
|
|
|
|
|
|
|
|
foreach ( $res as $row ) {
|
|
|
|
|
$oldName = $row->user_name;
|
2024-01-17 17:48:40 +00:00
|
|
|
$batchConds = [ $dbr->expr( 'user_name', '>', $oldName ) ];
|
2023-03-06 01:16:39 +00:00
|
|
|
$variablePart = $fromPattern->extract( $oldName );
|
|
|
|
|
if ( $variablePart === null ) {
|
|
|
|
|
$this->output( "Username \"fromName\" matched the LIKE " .
|
|
|
|
|
"but does not seem to match the pattern" );
|
|
|
|
|
continue;
|
|
|
|
|
}
|
|
|
|
|
$newName = $toPattern->generate( $variablePart );
|
2023-05-30 01:20:59 +00:00
|
|
|
|
|
|
|
|
// Canonicalize
|
|
|
|
|
$newTitle = $this->titleFactory->makeTitleSafe( NS_USER, $newName );
|
|
|
|
|
$newUser = $this->userFactory->newFromName( $newName );
|
|
|
|
|
if ( !$newTitle || !$newUser ) {
|
|
|
|
|
$this->output( "Cannot rename \"$oldName\" " .
|
|
|
|
|
"because \"$newName\" is not a valid title\n" );
|
|
|
|
|
continue;
|
|
|
|
|
}
|
|
|
|
|
$newName = $newTitle->getText();
|
|
|
|
|
|
|
|
|
|
// Check destination existence
|
|
|
|
|
if ( $newUser->isRegistered() ) {
|
|
|
|
|
$this->output( "Cannot rename \"$oldName\" " .
|
|
|
|
|
"because \"$newName\" already exists\n" );
|
|
|
|
|
continue;
|
|
|
|
|
}
|
|
|
|
|
|
2023-03-06 01:16:39 +00:00
|
|
|
$numRenamed += $this->renameUser( $oldName, $newName ) ? 1 : 0;
|
|
|
|
|
$this->waitForReplication();
|
|
|
|
|
}
|
|
|
|
|
} while ( $res->numRows() === $batchSize );
|
|
|
|
|
$this->output( "Renamed $numRenamed user(s)\n" );
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @param string $oldName
|
|
|
|
|
* @param string $newName
|
|
|
|
|
* @return bool True if the user was renamed
|
|
|
|
|
*/
|
|
|
|
|
private function renameUser( $oldName, $newName ) {
|
|
|
|
|
$id = $this->userFactory->newFromName( $oldName )->getId();
|
|
|
|
|
if ( !$id ) {
|
|
|
|
|
$this->output( "Cannot rename non-existent user \"$oldName\"" );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ( $this->dryRun ) {
|
|
|
|
|
$this->output( "$oldName would be renamed to $newName\n" );
|
|
|
|
|
} else {
|
|
|
|
|
$renamer = new RenameuserSQL(
|
|
|
|
|
$oldName,
|
|
|
|
|
$newName,
|
|
|
|
|
$id,
|
|
|
|
|
$this->performer,
|
|
|
|
|
[
|
|
|
|
|
'reason' => $this->reason
|
|
|
|
|
]
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
if ( !$renamer->rename() ) {
|
|
|
|
|
$this->output( "Unable to rename $oldName" );
|
|
|
|
|
return false;
|
|
|
|
|
} else {
|
|
|
|
|
$this->output( "$oldName was successfully renamed to $newName.\n" );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ( $this->skipPageMoves ) {
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
2023-03-14 01:22:23 +00:00
|
|
|
$this->movePageAndSubpages( NS_USER, 'User', $oldName, $newName );
|
|
|
|
|
$this->movePageAndSubpages( NS_USER_TALK, 'User talk', $oldName, $newName );
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private function movePageAndSubpages( $ns, $nsName, $oldName, $newName ) {
|
|
|
|
|
$oldTitle = $this->titleFactory->makeTitleSafe( $ns, $oldName );
|
2023-03-06 01:16:39 +00:00
|
|
|
if ( !$oldTitle ) {
|
2023-03-14 01:22:23 +00:00
|
|
|
$this->output( "[[$nsName:$oldName]] is an invalid title, can't move it.\n" );
|
2023-03-06 01:16:39 +00:00
|
|
|
return true;
|
|
|
|
|
}
|
2023-03-14 01:22:23 +00:00
|
|
|
$newTitle = $this->titleFactory->makeTitleSafe( $ns, $newName );
|
2023-03-06 01:16:39 +00:00
|
|
|
if ( !$newTitle ) {
|
2023-03-14 01:22:23 +00:00
|
|
|
$this->output( "[[$nsName:$newName]] is an invalid title, can't move to it.\n" );
|
2023-03-06 01:16:39 +00:00
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$movePage = $this->movePageFactory->newMovePage( $oldTitle, $newTitle );
|
|
|
|
|
$movePage->setMaximumMovedPages( -1 );
|
|
|
|
|
|
|
|
|
|
$logMessage = wfMessage(
|
|
|
|
|
'renameuser-move-log', $oldName, $newName
|
|
|
|
|
)->inContentLanguage()->text();
|
|
|
|
|
|
|
|
|
|
if ( $this->dryRun ) {
|
|
|
|
|
if ( $oldTitle->exists() ) {
|
2023-03-14 01:22:23 +00:00
|
|
|
$this->output( "Would move [[$nsName:$oldName]] to [[$nsName:$newName]].\n" );
|
2023-03-06 01:16:39 +00:00
|
|
|
}
|
|
|
|
|
} else {
|
|
|
|
|
if ( $oldTitle->exists() ) {
|
|
|
|
|
$status = $movePage->move(
|
|
|
|
|
$this->performer, $logMessage, !$this->suppressRedirect );
|
|
|
|
|
} else {
|
|
|
|
|
$status = Status::newGood();
|
|
|
|
|
}
|
|
|
|
|
$status->merge( $movePage->moveSubpages(
|
|
|
|
|
$this->performer, $logMessage, !$this->suppressRedirect ) );
|
|
|
|
|
if ( !$status->isGood() ) {
|
Maintenance: Print errors from StatusValue objects in a consistent way
Allow Maintenance::error() and Maintenance::fatalError() to take
StatusValue objects. They now print each error message from the
status on a separate line, in English, ignoring on-wiki message
overrides, as wikitext but after parser function expansion.
Thoughts on the previously commonly used methods:
- $status->getMessage( false, false, 'en' )->text()
Almost the same as the new output, but it allows on-wiki message
overrides, and if there is more than one error, it prefixes each
line with a '*' (like a wikitext list).
- $status->getMessage( false, false, 'en' )->plain()
- $status->getWikiText( false, false, 'en' )
As above, but these forms do not expand parser functions
such as {{GENDER:}}.
- print_r( $status->getErrorsArray(), true )
- print_r( $status->getErrors(), true )
These forms output the message keys instead of the message text,
which is not very human-readable.
The error messages are now always printed using error() rather
than output(), which means they go to STDERR rather than STDOUT
and they're printed even with the --quiet flag.
Change-Id: I5b8e7c7ed2a896a1029f58857a478d3f1b4b0589
2024-06-06 23:50:00 +00:00
|
|
|
$this->output( "Failed to rename user page\n" );
|
|
|
|
|
$this->error( $status );
|
2023-03-06 01:16:39 +00:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2024-08-27 12:00:25 +00:00
|
|
|
// @codeCoverageIgnoreStart
|
2023-03-06 01:16:39 +00:00
|
|
|
$maintClass = RenameUsersMatchingPattern::class;
|
|
|
|
|
require_once RUN_MAINTENANCE_IF_MAIN;
|
2024-08-27 12:00:25 +00:00
|
|
|
// @codeCoverageIgnoreEnd
|