Manual:recountCategories.php
| MediaWiki version: | ≥ 1.30 |
| MediaWiki file: recountCategories.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.42.4 • 1.41.5 • 1.39.11 |
| Classes: | RecountCategories |
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 Wikimedia 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/run.php recountCategories --mode modeName [ --begin| --throttle| --skip-cleanup ]
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.With pages mode
[edit]Terminal
$ php maintenance/run.php recountCategories --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/run.php recountCategories --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/run.php recountCategories --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.