InterwikiLookup implementing the "classic" interwiki storage (hardcoded up to MW 1.26). More...

Inheritance diagram for MediaWiki\Interwiki\ClassicInterwikiLookup:

Collaboration diagram for MediaWiki\Interwiki\ClassicInterwikiLookup:

[legend]

Public Member Functions
	__construct (Language $contLang, WANObjectCache $objectCache, HookContainer $hookContainer, ILoadBalancer $loadBalancer, $objectCacheExpiry, $cdbData, $interwikiScopes, $fallbackSite)

	fetch ( $prefix)
	Fetch an Interwiki object. More...

	getAllPrefixes ( $local=null)
	Returns all interwiki prefixes. More...

	invalidateCache ( $prefix)
	Purge the in-process and object cache for an interwiki prefix. More...

	isValidInterwiki ( $prefix)
	Check whether an interwiki prefix exists. More...

	resetLocalCache ()
	Resets locally cached Interwiki objects. More...

Static Public Member Functions
static	buildCdbHash (array $allPrefixes, int $scope=1, ?string $thisSite=null)
	Given the array returned by getAllPrefixes(), build a PHP hash which can be given to \Cdb\Reader\Hash() as $this->cdbData, ie as the value of $wgInterwikiCache. More...

Private Member Functions
	getAllPrefixesCached ( $local)
	Fetch all interwiki prefixes from interwiki cache. More...

	getAllPrefixesDB ( $local)
	Fetch all interwiki prefixes from DB. More...

	getCacheValue ( $key)

	getInterwikiCached ( $prefix)
	Fetch interwiki prefix data from local cache in constant database. More...

	getInterwikiCacheEntry ( $prefix)
	Get entry from interwiki cache. More...

	load ( $prefix)
	Load the interwiki, trying first memcached then the DB. More...

	loadFromArray ( $mc)
	Fill in member variables from an array (e.g. More...

Static Private Member Functions
static	selectFields ()
	Return the list of interwiki fields that should be selected to create a new Interwiki object. More...

Private Attributes
bool array string	$cdbData

CdbReader null	$cdbReader = null

Language	$contLang

string	$fallbackSite

HookRunner	$hookRunner

int	$interwikiScopes

ILoadBalancer	$loadBalancer

MapCacheLRU	$localCache

WANObjectCache	$objectCache

int	$objectCacheExpiry

string null	$thisSite = null

Detailed Description

InterwikiLookup implementing the "classic" interwiki storage (hardcoded up to MW 1.26).

This implements two levels of caching (in-process array and a WANObjectCache) and three storage backends (SQL, CDB, and plain PHP arrays).

All information is loaded on creation when called by $this->fetch( $prefix ). All work is done on replica DB, because this should never change (except during schema updates etc, which aren't wiki-related)

Since: 1.28

Definition at line 49 of file ClassicInterwikiLookup.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Interwiki\ClassicInterwikiLookup::__construct	(	Language	$contLang,
		WANObjectCache	$objectCache,
		HookContainer	$hookContainer,
		ILoadBalancer	$loadBalancer,
			$objectCacheExpiry,
			$cdbData,
			$interwikiScopes,
			$fallbackSite
	)

Parameters

Language	$contLang	Language object used to convert prefixes to lower case
WANObjectCache	$objectCache	Cache for interwiki info retrieved from the database
HookContainer	$hookContainer
ILoadBalancer	$loadBalancer
int	$objectCacheExpiry	Expiry time for $objectCache, in seconds
bool \| array \| string	$cdbData	The path of a CDB file, or an array resembling the contents of a CDB file, or false to use the database.
int	$interwikiScopes	Specify number of domains to check for messages: 1: Just local wiki level 2: wiki and global levels 3: site level as well as wiki and global levels
string	$fallbackSite	The code to assume for the local site,

Definition at line 117 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\$cdbData, MediaWiki\Interwiki\ClassicInterwikiLookup\$contLang, MediaWiki\Interwiki\ClassicInterwikiLookup\$fallbackSite, MediaWiki\Interwiki\ClassicInterwikiLookup\$interwikiScopes, MediaWiki\Interwiki\ClassicInterwikiLookup\$loadBalancer, MediaWiki\Interwiki\ClassicInterwikiLookup\$objectCache, and MediaWiki\Interwiki\ClassicInterwikiLookup\$objectCacheExpiry.

Member Function Documentation

◆ buildCdbHash()

static MediaWiki\Interwiki\ClassicInterwikiLookup::buildCdbHash	(	array	$allPrefixes,
		int	$scope = `1`,
		?string	$thisSite = `null`
	)

static

Given the array returned by getAllPrefixes(), build a PHP hash which can be given to \Cdb\Reader\Hash() as $this->cdbData, ie as the value of $wgInterwikiCache.

This is used to construct mock interwiki lookup services for testing (in particular, parsertests).

Parameters

array	$allPrefixes	An array of interwiki information such as would be returned by ::getAllPrefixes()
int	$scope	The scope at which to insert interwiki prefixes. See the $interwikiScopes parameter to ::__construct().
	?string	$thisSite The value of $thisSite, if $scope is 3.

Returns: array A PHP associative array suitable to use as $wgInterwikiCache

Definition at line 425 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\$thisSite, and WikiMap\getCurrentWikiId().

◆ fetch()

MediaWiki\Interwiki\ClassicInterwikiLookup::fetch ( $prefix )

Fetch an Interwiki object.

Parameters

string $prefix Interwiki prefix to use

Returns: Interwiki|null|bool

Implements MediaWiki\Interwiki\InterwikiLookup.

Definition at line 157 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCached(), and MediaWiki\Interwiki\ClassicInterwikiLookup\load().

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\isValidInterwiki().

◆ getAllPrefixes()

MediaWiki\Interwiki\ClassicInterwikiLookup::getAllPrefixes ( $local = null )

Returns all interwiki prefixes.

Parameters

string | null $local If set, limits output to local/non-local interwikis

Returns: array[] Interwiki rows, where each row is an associative array

Implements MediaWiki\Interwiki\InterwikiLookup.

Definition at line 486 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached(), and MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesDB().

◆ getAllPrefixesCached()

MediaWiki\Interwiki\ClassicInterwikiLookup::getAllPrefixesCached ( $local )

private

Fetch all interwiki prefixes from interwiki cache.

Parameters

null | string $local If not null, limits output to local/non-local interwikis

Returns: array List of prefixes, where each row is an associative array

Definition at line 353 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\$fallbackSite, $source, MediaWiki\Interwiki\ClassicInterwikiLookup\$thisSite, MediaWiki\Interwiki\ClassicInterwikiLookup\getCacheValue(), WikiMap\getCurrentWikiId(), and wfDebug().

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixes().

◆ getAllPrefixesDB()

MediaWiki\Interwiki\ClassicInterwikiLookup::getAllPrefixesDB ( $local )

private

Fetch all interwiki prefixes from DB.

Parameters

string | null $local If not null, limits output to local/non-local interwikis

Returns: array[] Interwiki rows

Definition at line 454 of file ClassicInterwikiLookup.php.

References $res, and DB_REPLICA.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixes().

◆ getCacheValue()

MediaWiki\Interwiki\ClassicInterwikiLookup::getCacheValue ( $key )

private

Definition at line 263 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached(), and MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry().

◆ getInterwikiCached()

MediaWiki\Interwiki\ClassicInterwikiLookup::getInterwikiCached ( $prefix )

private

Fetch interwiki prefix data from local cache in constant database.

Note: More logic is explained in DefaultSettings.

Parameters

string $prefix Interwiki prefix

Returns: Interwiki|false

Definition at line 208 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry().

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\fetch().

◆ getInterwikiCacheEntry()

MediaWiki\Interwiki\ClassicInterwikiLookup::getInterwikiCacheEntry ( $prefix )

private

Get entry from interwiki cache.

Note: More logic is explained in DefaultSettings.

Parameters

string $prefix Database key

Returns: bool|string The interwiki entry or false if not found

Definition at line 228 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\$fallbackSite, MediaWiki\Interwiki\ClassicInterwikiLookup\getCacheValue(), WikiMap\getCurrentWikiId(), and wfDebug().

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCached().

◆ invalidateCache()

MediaWiki\Interwiki\ClassicInterwikiLookup::invalidateCache ( $prefix )

Purge the in-process and object cache for an interwiki prefix.

Parameters

string $prefix

Implements MediaWiki\Interwiki\InterwikiLookup.

Definition at line 193 of file ClassicInterwikiLookup.php.

◆ isValidInterwiki()

MediaWiki\Interwiki\ClassicInterwikiLookup::isValidInterwiki ( $prefix )

Check whether an interwiki prefix exists.

Parameters

string $prefix Interwiki prefix to use

Returns: bool Whether it exists

Implements MediaWiki\Interwiki\InterwikiLookup.

Definition at line 145 of file ClassicInterwikiLookup.php.

References MediaWiki\Interwiki\ClassicInterwikiLookup\fetch().

◆ load()

MediaWiki\Interwiki\ClassicInterwikiLookup::load ( $prefix )

private

Load the interwiki, trying first memcached then the DB.

Parameters

string $prefix The interwiki prefix

Returns: Interwiki|bool Interwiki if $prefix is valid, otherwise false

Definition at line 287 of file ClassicInterwikiLookup.php.

References $dbr, DB_REPLICA, Wikimedia\Rdbms\Database\getCacheSetOptions(), and MediaWiki\Interwiki\ClassicInterwikiLookup\loadFromArray().

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\fetch().

◆ loadFromArray()

MediaWiki\Interwiki\ClassicInterwikiLookup::loadFromArray ( $mc )

private

Fill in member variables from an array (e.g.

memcached result, Database::fetchRow, etc)

Parameters

array $mc Associative array: row from the interwiki table

Returns: Interwiki|bool Interwiki object or false if $mc['iw_url'] is not set

Definition at line 333 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\load().

◆ resetLocalCache()

MediaWiki\Interwiki\ClassicInterwikiLookup::resetLocalCache ( )

Resets locally cached Interwiki objects.

This is intended for use during testing only. This does not invalidate entries in the persistent cache, as invalidateCache() does.

Since: 1.27

Definition at line 185 of file ClassicInterwikiLookup.php.

◆ selectFields()

static MediaWiki\Interwiki\ClassicInterwikiLookup::selectFields ( )

staticprivate

Return the list of interwiki fields that should be selected to create a new Interwiki object.

Returns: string[]

Definition at line 499 of file ClassicInterwikiLookup.php.

Member Data Documentation

◆ $cdbData

bool array string MediaWiki\Interwiki\ClassicInterwikiLookup::$cdbData

private

Definition at line 74 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\__construct().

◆ $cdbReader

CdbReader null MediaWiki\Interwiki\ClassicInterwikiLookup::$cdbReader = null

private

Definition at line 89 of file ClassicInterwikiLookup.php.

◆ $contLang

Language MediaWiki\Interwiki\ClassicInterwikiLookup::$contLang

private

Definition at line 59 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\__construct().

◆ $fallbackSite

string MediaWiki\Interwiki\ClassicInterwikiLookup::$fallbackSite

private

Definition at line 84 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\__construct(), MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached(), and MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry().

◆ $hookRunner

HookRunner MediaWiki\Interwiki\ClassicInterwikiLookup::$hookRunner

private

Definition at line 97 of file ClassicInterwikiLookup.php.

◆ $interwikiScopes

int MediaWiki\Interwiki\ClassicInterwikiLookup::$interwikiScopes

private

Definition at line 79 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\__construct().

◆ $loadBalancer

ILoadBalancer MediaWiki\Interwiki\ClassicInterwikiLookup::$loadBalancer

private

Definition at line 100 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\__construct().

◆ $localCache

MapCacheLRU MediaWiki\Interwiki\ClassicInterwikiLookup::$localCache

private

Definition at line 54 of file ClassicInterwikiLookup.php.

◆ $objectCache

WANObjectCache MediaWiki\Interwiki\ClassicInterwikiLookup::$objectCache

private

Definition at line 64 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\__construct().

◆ $objectCacheExpiry

int MediaWiki\Interwiki\ClassicInterwikiLookup::$objectCacheExpiry

private

Definition at line 69 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\__construct().

◆ $thisSite

string null MediaWiki\Interwiki\ClassicInterwikiLookup::$thisSite = null

private

Definition at line 94 of file ClassicInterwikiLookup.php.

Referenced by MediaWiki\Interwiki\ClassicInterwikiLookup\buildCdbHash(), and MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached().

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

includes/interwiki/ClassicInterwikiLookup.php

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ buildCdbHash()

◆ fetch()

◆ getAllPrefixes()

◆ getAllPrefixesCached()

◆ getAllPrefixesDB()

◆ getCacheValue()

◆ getInterwikiCached()

◆ getInterwikiCacheEntry()

◆ invalidateCache()

◆ isValidInterwiki()

◆ load()

◆ loadFromArray()

◆ resetLocalCache()

◆ selectFields()

Member Data Documentation

◆ $cdbData

◆ $cdbReader

◆ $contLang

◆ $fallbackSite

◆ $hookRunner

◆ $interwikiScopes

◆ $loadBalancer

◆ $localCache

◆ $objectCache

◆ $objectCacheExpiry

◆ $thisSite