Manual:cleanupTitles.php

MediaWiki version:

≥ 1.6

MediaWiki file: cleanupTitles.php
Location:	maintenance/
Source code:	master • 1.43.0 • 1.42.4 • 1.39.11
Classes:	TitleCleanup

Details

cleanupTitles.php is a maintenance script located in the maintenance directory that can be used to clean up broken, unparseable titles. The edits will be attributed to the user called Conversion script. This script is rather useful for cases in which someone has added a new interwiki prefix (e.g. commandos:) to the interwiki table and thereby caused mainspace pages with ambiguous titles (e.g. Commandos: Behind Enemy Lines) to become inaccessible. Likewise, the script can be used to process changes in $wgLegalTitleChars that rendered previously valid page titles inaccessible. Note that namespaceDupes.php is often a preferable option, if the goal is to move pages into their proper namespace.

Also note, this script does not support fixing encoding issues (e.g. Pages that are not UTF-8 NFC) at current time.

Options/Arguments

Option	Description	Required?
--dry-run	Perform a dry run	Optional
--reporting-interval	How often to print status line	Optional

Usage

php maintenance/run.php cleanupTitles [ --dry-run| --reporting-interval ]

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.

Checking for bad titles with dry-run

Terminal

$ php maintenance/run.php cleanupTitles --dry-run

Checking for bad titles...
Processing page...
page 1 (main_Page) doesn't match self.
DRY RUN: would rename 1 (0,'main_Page') to (0,'Broken/Main_Page')
page 2 (saraswati_Maa) doesn't match self.
DRY RUN: would rename 2 (0,'saraswati_Maa') to (0,'Broken/Saraswati_Maa')
page 4 (abc) doesn't match self.
DRY RUN: would rename 4 (0,'abc') to (0,'Broken/Abc')
Finished page... 3 of 11 rows updated

Checking and fixing bad titles