Manual:PurgePage.php
| MediaWiki version: | ≥ 1.30 |
| MediaWiki file: purgePage.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.42.3 • 1.41.4 • 1.39.10 |
| 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.