Manual:recountCategories.php

From mediawiki.org
Other languages:
MediaWiki version:
1.30

Details[edit]

recountCategories.php is a maintenance script used to update the counts of category members, if the numbers displayed on category pages are inaccurate. During normal operation, it shouldn't be needed to run this script. However, a bug may cause the counts to not update properly (see task T18036 and task T85696 and task T170737, the script was run on all public wikis 2021-06-23).

Options/Arguments[edit]

Option Description Required?
--mode Which category count column to recompute: one of pages, subcats or files. Required
--begin Only recount categories with cat_id greater than the given value Optional
--throttle Wait this many milliseconds after each batch. Default: 0 Optional
--skip-cleanup Skip running cleanupEmptyCategories if the "page" mode is selected Optional

Usage[edit]

php maintenance/recountCategories.php --mode modeName [ --begin| --throttle| --skip-cleanup ]


With pages mode[edit]

Terminal
$ php maintenance/recountCategories.php --mode pages

Starting to recount pages counts.
Finding up to 500 drifted rows greater than cat_id 0...
Updated the pages counts of 0 categories.
Done!

Now run the script using the other --mode options if you haven't already.
Running cleanupEmptyCategories.php
Adding empty categories with description pages...
Removing empty categories without description pages...
Category cleanup complete.

With subcats mode[edit]

Terminal
$ php maintenance/recountCategories.php --mode subcats

Starting to recount subcats counts.
Finding up to 500 drifted rows greater than cat_id 0...
Updated the subcats counts of 0 categories.
Done!

Now run the script using the other --mode options if you haven't already.

With files mode[edit]

Terminal
$ php maintenance/recountCategories.php --mode files

Starting to recount files counts.
Finding up to 500 drifted rows greater than cat_id 0...
Updated the files counts of 0 categories.
Done!

Now run the script using the other --mode options if you haven't already.

See also[edit]