Manual:purgePage.php

MediaWiki version:

≥ 1.30

MediaWiki file: purgePage.php
Location:	maintenance/
Source code:	master • 1.38.2 • 1.37.4 • 1.35.7
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

Options/Arguments

Option	Description	Required?
--skip-exists-check	Skip page existence check	Optional

Usage

php maintenance/purgePage.php [ --skip-exists-check ]

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

Terminal

$ php maintenance/purgePage.php

Page 1
Purged Page 1
Main page
Page doesn't exist
Main Page
Purged Main Page

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

Terminal

$ php maintenance/purgePage.php < purge.txt

Purged Page 1
Page doesn't exist
Purged Main Page

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

See also

• Purge
• PurgeList.php
• PurgeOldText.php