Manual:purgePage.php

MediaWiki file: purgePage.php
Location:	maintenance/
Source code:	master • 1.34.2 • 1.33.4 • 1.31.8
Classes:	PurgePage

Details

purgePage.php file is a maintenance script to purge both internal and external caches.

This is the equivalent to action=purge (task T169195) and performs the following actions:

• Re-parses the wikitext, saves changes to the database (e.g. current expansion of magic words and templates, writes links to the database for images, links-here, categories etc.).
• Performs a database write for page.page_touched to the current time, which has potential cascading effects to other areas of the application.
• Purges the page's canonical URLs from File cache ($wgUseFileCache) and/or from external Squid/Varnish proxy (this is the part that purgeList.php does).
• In addition, individual page types (such as FilePage) and extensions, may register additional actions. For example, when purging a File page, it also deletes thumbnails from Swift storage, and purge the URLs of all thumbnail sizes and variations (page1, page2, 120px, 320px etc. etc.)

Warning:

If using file cache, it is important to run this script as the same user as mediawiki (or your web server) runs as. Otherwise the script might not have filesystem rights to delete filecache entries

Syntax

Give a list of page titles to purge, one per line, from standard input:

php purgePage.php
Page 1
PURGED
Page 2
PURGED
Page 3
PURGED

Give a list of page titles to purge, one per line, from a file:

php purgePage.php < purge.txt

where purge.txt contains a list of pagenames to be regenerated.

See also

• purgeList.php