Manual:findMissingActors.php
| MediaWiki version: | ≥ 1.34 Gerrit change 625731 |
| MediaWiki file: findMissingActors.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.43.0 • 1.42.4 • 1.39.11 |
| Classes: | FindMissingActors |
Details
[edit]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
[edit]| Option | Description | Required? |
|---|---|---|
| --field | The name of a database field to process | Required |
| --skip | A comma-separated list of actor IDs to skip | Optional |
| --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
[edit]php maintenance/run.php findMissingActors --field [ --skip| --overwrite-with ]
Terminal
$ php maintenance/run.php findMissingActors --field log_actor Finding invalid actor IDs in logging.log_actor... Found 0 invalid actor IDs. Done.
In MediaWiki version 1.39.10 and earlier, you must invoke maintenance scripts using
php maintenance/scriptName.php instead of php maintenance/run.php scriptName.