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, $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...

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

int	$interwikiScopes

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 tree 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 47 of file ClassicInterwikiLookup.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Interwiki\ClassicInterwikiLookup::__construct	(	Language	$contLang,
		WANObjectCache	$objectCache,
			$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
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 107 of file ClassicInterwikiLookup.php.

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

Member Function Documentation

◆ 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 143 of file ClassicInterwikiLookup.php.

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

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 436 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 339 of file ClassicInterwikiLookup.php.

References $e, MediaWiki\Interwiki\ClassicInterwikiLookup\$fallbackSite, $source, MediaWiki\Interwiki\ClassicInterwikiLookup\$thisSite, as, MediaWiki\Interwiki\ClassicInterwikiLookup\getCacheValue(), WikiMap\getCurrentWikiDbDomain(), WikiMap\getWikiIdFromDbDomain(), list, null, 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 404 of file ClassicInterwikiLookup.php.

References $res, as, DB_REPLICA, null, and wfGetDB().

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

◆ getCacheValue()

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

private

Definition at line 249 of file ClassicInterwikiLookup.php.

References null, and Makefile\open.

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 194 of file ClassicInterwikiLookup.php.

References $value, MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry(), and list.

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 214 of file ClassicInterwikiLookup.php.

References $e, MediaWiki\Interwiki\ClassicInterwikiLookup\$fallbackSite, $value, MediaWiki\Interwiki\ClassicInterwikiLookup\getCacheValue(), WikiMap\getCurrentWikiDbDomain(), WikiMap\getWikiIdFromDbDomain(), 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 179 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 131 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 273 of file ClassicInterwikiLookup.php.

References $dbr, $fname, MediaWiki\Interwiki\ClassicInterwikiLookup\$objectCacheExpiry, DB_REPLICA, Wikimedia\Rdbms\Database\getCacheSetOptions(), MediaWiki\Interwiki\ClassicInterwikiLookup\loadFromArray(), Hooks\run(), use, and wfGetDB().

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 319 of file ClassicInterwikiLookup.php.

References null.

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 171 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 449 of file ClassicInterwikiLookup.php.

Member Data Documentation

◆ $cdbData

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

private

Definition at line 72 of file ClassicInterwikiLookup.php.

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

◆ $cdbReader

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

private

Definition at line 87 of file ClassicInterwikiLookup.php.

◆ $contLang

Language MediaWiki\Interwiki\ClassicInterwikiLookup::$contLang

private

Definition at line 57 of file ClassicInterwikiLookup.php.

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

◆ $fallbackSite

string MediaWiki\Interwiki\ClassicInterwikiLookup::$fallbackSite

private

Definition at line 82 of file ClassicInterwikiLookup.php.

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

◆ $interwikiScopes

int MediaWiki\Interwiki\ClassicInterwikiLookup::$interwikiScopes

private

Definition at line 77 of file ClassicInterwikiLookup.php.

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

◆ $localCache

MapCacheLRU MediaWiki\Interwiki\ClassicInterwikiLookup::$localCache

private

Definition at line 52 of file ClassicInterwikiLookup.php.

◆ $objectCache

WANObjectCache MediaWiki\Interwiki\ClassicInterwikiLookup::$objectCache

private

Definition at line 62 of file ClassicInterwikiLookup.php.

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

◆ $objectCacheExpiry

int MediaWiki\Interwiki\ClassicInterwikiLookup::$objectCacheExpiry

private

Definition at line 67 of file ClassicInterwikiLookup.php.

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

◆ $thisSite

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

private

Definition at line 92 of file ClassicInterwikiLookup.php.

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

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

includes/interwiki/ClassicInterwikiLookup.php

Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ fetch()

◆ getAllPrefixes()

◆ getAllPrefixesCached()

◆ getAllPrefixesDB()

◆ getCacheValue()

◆ getInterwikiCached()

◆ getInterwikiCacheEntry()

◆ invalidateCache()

◆ isValidInterwiki()

◆ load()

◆ loadFromArray()

◆ resetLocalCache()

◆ selectFields()

Member Data Documentation

◆ $cdbData

◆ $cdbReader

◆ $contLang

◆ $fallbackSite

◆ $interwikiScopes

◆ $localCache

◆ $objectCache

◆ $objectCacheExpiry

◆ $thisSite