Handles purging appropriate Squid URLs given a title (or titles) More...

Collaboration diagram for SquidUpdate:

Public Member Functions
	__construct ($urlArr=array(), $maxTitles=false)
	doUpdate ()
	Purges the list of URLs passed to the constructor.
Static Public Member Functions
static	expand ($url)
	Expand local URLs to fully-qualified URLs using the internal protocol and host defined in $wgInternalServer.
static	HTCPPurge ($urlArr)
	Send Hyper Text Caching Protocol (HTCP) CLR requests.
static	newFromLinksTo (Title $title)
	Create a SquidUpdate from the given Title object.
static	newFromTitles ($titles, $urlArr=array())
	Create a SquidUpdate from an array of Title objects, or a TitleArray object.
static	newSimplePurge (Title $title)
static	purge ($urlArr)
	Purges a list of Squids defined in $wgSquidServers.
Protected Attributes
array	$urlArr
	Collection of URLs to purge.
Static Private Member Functions
static	getRuleForURL ($url, $rules)
	Find the HTCP routing rule to use for a given URL.

Detailed Description

Handles purging appropriate Squid URLs given a title (or titles)

Definition at line 28 of file SquidUpdate.php.

Constructor & Destructor Documentation

SquidUpdate::__construct	(	$	urlArr = `array()`,
		$	maxTitles = `false`
	)

Parameters:

array	$urlArr	Collection of URLs to purge
bool \| int	$maxTitles	Maximum number of unique URLs to purge

Definition at line 38 of file SquidUpdate.php.

Member Function Documentation

SquidUpdate::doUpdate ( )

Purges the list of URLs passed to the constructor.

Definition at line 122 of file SquidUpdate.php.

static SquidUpdate::expand ( $ url ) [static]

Expand local URLs to fully-qualified URLs using the internal protocol and host defined in $wgInternalServer.

Input that's already fully- qualified will be passed through unchanged.

This is used to generate purge URLs that may be either local to the main wiki or include a non-native host, such as images hosted on a second internal server.

Client functions should not need to call this.

Parameters:

string $url

Returns:: string

Definition at line 291 of file SquidUpdate.php.

Referenced by SquidPurgeClient\queuePurge().

static SquidUpdate::getRuleForURL	(	$	url,
		$	rules
	)		`[static, private]`

Find the HTCP routing rule to use for a given URL.

Parameters:

string	$url	URL to match
array	$rules	Array of rules, see $wgHTCPRouting for format and behavior

Returns:: mixed Element of $rules that matched, or false if nothing matched

Definition at line 301 of file SquidUpdate.php.

static SquidUpdate::HTCPPurge ( $ urlArr ) [static]

Send Hyper Text Caching Protocol (HTCP) CLR requests.

Exceptions:

MWException

Parameters:

array $urlArr Collection of URLs to purge

Definition at line 183 of file SquidUpdate.php.

static SquidUpdate::newFromLinksTo ( Title $ title ) [static]

Create a SquidUpdate from the given Title object.

The resulting SquidUpdate will purge the given Title's URLs as well as the pages that link to it. Capped at $wgMaxSquidPurgeTitles total URLs.

Parameters:

Title $title

Returns:: SquidUpdate

Definition at line 62 of file SquidUpdate.php.

static SquidUpdate::newFromTitles	(	$	titles,
		$	urlArr = `array()`
	)		`[static]`

Create a SquidUpdate from an array of Title objects, or a TitleArray object.

Parameters:

array	$titles
array	$urlArr

Returns:: SquidUpdate

Definition at line 95 of file SquidUpdate.php.

Referenced by HTMLCacheUpdateJob\invalidateTitles().

static SquidUpdate::newSimplePurge ( Title $ title ) [static]

Parameters:

Title $title

Returns:: SquidUpdate

Definition at line 113 of file SquidUpdate.php.

static SquidUpdate::purge ( $ urlArr ) [static]

Purges a list of Squids defined in $wgSquidServers.

$urlArr should contain the full URLs to purge as values (example: $urlArr[] = 'http://my.host/something') XXX report broken Squids per mail or log

Parameters:

array $urlArr List of full URLs to purge

Definition at line 134 of file SquidUpdate.php.

Referenced by BenchmarkPurge\benchSquid(), RevDel_FileList\doPostCommitUpdates(), File\getThumbDisposition(), and LocalFile\purgeOldThumbnails().

Member Data Documentation

array SquidUpdate::$urlArr [protected]

Collection of URLs to purge.

Definition at line 32 of file SquidUpdate.php.

The documentation for this class was generated from the following file:

includes/deferred/SquidUpdate.php

Public Member Functions

Static Public Member Functions

Protected Attributes

Static Private Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation