Manual:purgePage.php
From Linux Web Expert
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>">
<translate> ≥</translate> 1.30
| <translate> MediaWiki version:</translate> |
| MediaWiki file: purgePage.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.41.1 • 1.40.3 • 1.39.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 (<translate> task <tvar name=1>T169195</tvar></translate>) 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.)
Options/Arguments
| Option | Description | Required? |
|---|---|---|
| --skip-exists-check | Skip page existence check | <translate> Optional</translate> |
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.
