Manual:recountCategories.php

Other languages:
MediaWiki version:
1.30

DetailsEdit

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/ArgumentsEdit

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

UsageEdit

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


With pages modeEdit

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 modeEdit

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 modeEdit

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 alsoEdit