Manual:purgeChangedFiles.php

MediaWiki version:

≥ 1.22

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

Details

purgeChangedFiles.php file is a maintenance script to scan the logging table and to purge affected files and thumbnails within a timeframe. This script processes 100 items in a batch.

Options/Arguments

Option	Description	Required?
--starttime	Starting timestamp	Required
--endtime	Ending timestamp	Required
--type	Comma-separated list of types of changes to send purges for (created,deleted,modified,all)	Optional
--htcp-dest	HTCP announcement destination (IP:port)	Optional
--dry-run	Do not send purge requests	Optional
--sleep-per-batch	Milliseconds to sleep between batches	Optional
--verbose	Show more output	Optional

Usage

php maintenance/run.php purgeChangedFiles --starttime dt1 --endtime dt2 [ --type| --htcp-dest| --dry-run| --sleep-per-batch| --verbose ]

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.

Dry run to check purging

Terminal

$ php maintenance/run.php purgeChangedFiles --starttime 20210101 --endtime 20211231 --dry-run

Checking for created files...
Scanning for upload/upload
Scanning for import/upload,interwiki
Checking for deleted files...
Scanning for delete/delete,revision
Scanning for suppress/delete,revision
Checking for modified files...
Scanning for upload/overwrite,revert
Scanning for move/move,move_redir

Purging