Manual:purgeChangedFiles.php

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>">

<translate> ≥</translate> 1.22

<translate> MediaWiki version:</translate>

MediaWiki file: purgeChangedFiles.php
Location:	maintenance/
Source code:	master • 1.41.1 • 1.40.3 • 1.39.7
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	<translate> Required</translate>
--endtime	Ending timestamp	<translate> Required</translate>
--type	Comma-separated list of types of changes to send purges for (created,deleted,modified,all)	<translate> Optional</translate>
--htcp-dest	HTCP announcement destination (IP:port)	<translate> Optional</translate>
--dry-run	Do not send purge requests	<translate> Optional</translate>
--sleep-per-batch	Milliseconds to sleep between batches	<translate> Optional</translate>
--verbose	Show more output	<translate> Optional</translate>

Usage

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

Dry run to check purging

Terminal

$ php maintenance/purgeChangedFiles.php --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