MediaWiki REL1_32
purgeList.php
Go to the documentation of this file.
1<?php
24require_once __DIR__ . '/Maintenance.php';
25
31class PurgeList extends Maintenance {
32 public function __construct() {
33 parent::__construct();
34 $this->addDescription( 'Send purge requests for listed pages to squid' );
35 $this->addOption( 'purge', 'Whether to update page_touched.', false, false );
36 $this->addOption( 'namespace', 'Namespace number', false, true );
37 $this->addOption( 'all', 'Purge all pages', false, false );
38 $this->addOption( 'delay', 'Number of seconds to delay between each purge', false, true );
39 $this->addOption( 'verbose', 'Show more output', false, false, 'v' );
40 $this->setBatchSize( 100 );
41 }
42
43 public function execute() {
44 if ( $this->hasOption( 'all' ) ) {
45 $this->purgeNamespace( false );
46 } elseif ( $this->hasOption( 'namespace' ) ) {
47 $this->purgeNamespace( intval( $this->getOption( 'namespace' ) ) );
48 } else {
49 $this->doPurge();
50 }
51 $this->output( "Done!\n" );
52 }
53
57 private function doPurge() {
58 $stdin = $this->getStdin();
59 $urls = [];
60
61 while ( !feof( $stdin ) ) {
62 $page = trim( fgets( $stdin ) );
63 if ( preg_match( '%^https?://%', $page ) ) {
64 $urls[] = $page;
65 } elseif ( $page !== '' ) {
66 $title = Title::newFromText( $page );
67 if ( $title ) {
68 $url = $title->getInternalURL();
69 $this->output( "$url\n" );
70 $urls[] = $url;
71 if ( $this->getOption( 'purge' ) ) {
72 $title->invalidateCache();
73 }
74 } else {
75 $this->output( "(Invalid title '$page')\n" );
76 }
77 }
78 }
79 $this->output( "Purging " . count( $urls ) . " urls\n" );
80 $this->sendPurgeRequest( $urls );
81 }
82
88 private function purgeNamespace( $namespace = false ) {
89 $dbr = $this->getDB( DB_REPLICA );
90 $startId = 0;
91 if ( $namespace === false ) {
92 $conds = [];
93 } else {
94 $conds = [ 'page_namespace' => $namespace ];
95 }
96 while ( true ) {
97 $res = $dbr->select( 'page',
98 [ 'page_id', 'page_namespace', 'page_title' ],
99 $conds + [ 'page_id > ' . $dbr->addQuotes( $startId ) ],
100 __METHOD__,
101 [
102 'LIMIT' => $this->getBatchSize(),
103 'ORDER BY' => 'page_id'
104
105 ]
106 );
107 if ( !$res->numRows() ) {
108 break;
109 }
110 $urls = [];
111 foreach ( $res as $row ) {
112 $title = Title::makeTitle( $row->page_namespace, $row->page_title );
113 $url = $title->getInternalURL();
114 $urls[] = $url;
115 $startId = $row->page_id;
116 }
117 $this->sendPurgeRequest( $urls );
118 }
119 }
120
125 private function sendPurgeRequest( $urls ) {
126 if ( $this->hasOption( 'delay' ) ) {
127 $delay = floatval( $this->getOption( 'delay' ) );
128 foreach ( $urls as $url ) {
129 if ( $this->hasOption( 'verbose' ) ) {
130 $this->output( $url . "\n" );
131 }
132 $u = new CdnCacheUpdate( [ $url ] );
133 $u->doUpdate();
134 usleep( $delay * 1e6 );
135 }
136 } else {
137 if ( $this->hasOption( 'verbose' ) ) {
138 $this->output( implode( "\n", $urls ) . "\n" );
139 }
140 $u = new CdnCacheUpdate( $urls );
141 $u->doUpdate();
142 }
143 }
144}
145
146$maintClass = PurgeList::class;
147require_once RUN_MAINTENANCE_IF_MAIN;
Handles purging appropriate CDN URLs given a title (or titles)
Abstract maintenance class for quickly writing and churning out maintenance scripts with minimal effo...
output( $out, $channel=null)
Throw some output to the user.
getStdin( $len=null)
Return input from stdin.
getDB( $db, $groups=[], $wiki=false)
Returns a database to be used by current maintenance script.
hasOption( $name)
Checks to see if a particular option exists.
addDescription( $text)
Set the description text.
addOption( $name, $description, $required=false, $withArg=false, $shortName=false, $multiOccurrence=false)
Add a parameter to the script.
getOption( $name, $default=null)
Get an option, or return the default.
setBatchSize( $s=0)
Set the batch size.
Maintenance script that sends purge requests for listed pages to squid.
Definition purgeList.php:31
execute()
Do the actual work.
Definition purgeList.php:43
__construct()
Default constructor.
Definition purgeList.php:32
sendPurgeRequest( $urls)
Helper to purge an array of $urls.
purgeNamespace( $namespace=false)
Purge a namespace or all pages.
Definition purgeList.php:88
doPurge()
Purge URL coming from stdin.
Definition purgeList.php:57
$res
Definition database.txt:21
require_once RUN_MAINTENANCE_IF_MAIN
$maintClass
const DB_REPLICA
Definition defines.php:25