Manual:purgePage.php
| MediaWiki version: | ≥ 1.30 |
| MediaWiki file: purgePage.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.43.0 • 1.42.4 • 1.39.11 |
| Classes: | PurgePage |
Details
[edit]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
[edit]| Option | Description | Required? |
|---|---|---|
| --skip-exists-check | Skip page existence check | Optional |
Usage
[edit]php maintenance/run.php purgePage [ --skip-exists-check ]
In MediaWiki version 1.39.10 and earlier, you must invoke maintenance scripts using
php maintenance/scriptName.php instead of php maintenance/run.php scriptName.Give a list of page titles to purge, one per line, from standard input:
Terminal
$ php maintenance/run.php purgePage 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/run.php purgePage < purge.txt Purged Page 1 Page doesn't exist Purged Main Page
where purge.txt contains a list of pagenames to be regenerated.