Manual:FindMissingActors.php

MediaWiki version:
1.34
Gerrit change 625731
Category:MediaWiki code#FindMissingActors.php

Details

findMissingActors.php is a maintenance script for finding and replacing invalid actor IDs, see T261325.

This allows bad actor IDs to be overwritten with some default. This solves the problem of rows in tables like ipblocks, logging, or revision not being found due to a failing join against the actor table.

Options/Arguments

Option Description Required?
--field The name of a database field to processRequired
--skip A comma-separated list of actor IDs to skipOptional
--overwrite-with Replace missing actors with this user. Typically, this would be "Unknown user", but it could be any reserved system user (per $wgReservedUsernames) or locally registered user. If not given, invalid actors will only be listed, not fixed. You will be prompted for confirmation before data is written. Optional

Usage

php maintenance/run.php findMissingActors --field [ --skip| --overwrite-with ]
Terminal
In MediaWiki version 1.39.12 and earlier, you must invoke maintenance scripts using php maintenance/scriptName.php instead of php maintenance/run.php scriptName.

See also

Category:Maintenance scripts Category:User maintenance scripts
Category:Maintenance scripts Category:MediaWiki code Category:User maintenance scripts