Manual:purgeExpiredWatchlistItems.php
| MediaWiki version: | ≥ 1.35 |
| MediaWiki file: purgeExpiredWatchlistItems.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.44.2 • 1.43.5 • 1.39.15 |
| Classes: | Find code • Find documentation |
Details
[edit]purgeExpiredWatchlistItems.php is a maintenance script that deletes expired rows from the watchlist and watchlist_expiry database tables.
This script should be run periodically, for example, by a cron job.
The recommended periodicity is once or twice a day, to account for users on different timezones.
For improved site performance, $wgWatchlistPurgeRate can be set to 0.
Options
[edit]This script doesn't have any of its own parameters, and the most useful of the generic parameters is probably --batch-size, which determines how many rows will be deleted on each run (defaults to 500).
Usage
[edit]php maintenance/run.php purgeExpiredWatchlistItems
Terminal
$ php maintenance/run.php purgeExpiredWatchlistItems 7 expired watchlist entries found. All expired entries purged.
In MediaWiki version 1.39.15 and earlier, you must invoke maintenance scripts using
php maintenance/scriptName.php instead of php maintenance/run.php scriptName.Common error
[edit]- Watchlist expiry is not enabled.
An error is thrown if $wgWatchlistExpiry is not true.
Set $wgWatchlistExpiry = true; to enable.