Functions to get cache objects. More...

Collaboration diagram for ObjectCache:

Static Public Member Functions
static	clear ()
	Clear all the cached instances. More...

static	getDefaultKeyspace ()
	Get the default keyspace for this wiki. More...

static	getInstance ($id)
	Get a cached instance of the specified type of cache object. More...

static	getLocalClusterInstance ()
	Get the main cluster-local cache object. More...

static	getLocalServerInstance ($fallback=CACHE_NONE)
	Factory function for CACHE_ACCEL (referenced from DefaultSettings.php) More...

static	getMainStashInstance ()
	Get the cache object for the main stash. More...

static	getMainWANInstance ()
	Get the main WAN cache object. More...

static	getWANInstance ($id)
	Get a cached instance of the specified type of WAN cache object. More...

static	newAccelerator ($params=[], $fallback=null)

static	newAnything ($params)
	Factory function for CACHE_ANYTHING (referenced from DefaultSettings.php) More...

static	newFromId ($id)
	Create a new cache object of the specified type. More...

static	newFromParams ($params)
	Create a new cache object from parameters. More...

static	newWANCacheFromId ($id)
	Create a new cache object of the specified type. More...

Static Public Attributes
static BagOStuff[]	$instances = []
	Map of (id => BagOStuff) More...

static WANObjectCache[]	$wanInstances = []
	Map of (id => WANObjectCache) More...

Detailed Description

Functions to get cache objects.

The word "cache" has two main dictionary meanings, and both are used in this factory class. They are:

a) Cache (the computer science definition). A place to store copies or computations on existing data for higher access speeds.
b) Storage. A place to store lightweight data that is not canonically stored anywhere else (e.g. a "hoard" of objects).

The former should always use strongly consistent stores, so callers don't have to deal with stale reads. The later may be eventually consistent, but callers can use BagOStuff:READ_LATEST to see the latest available data.

Primary entry points:

ObjectCache::getMainWANInstance() Purpose: Memory cache. Stored in the local data-center's main cache (keyspace different from local-cluster cache). Delete events are broadcasted to other DCs main cache. See WANObjectCache for details.
ObjectCache::getLocalServerInstance( $fallbackType ) Purpose: Memory cache for very hot keys. Stored only on the individual web server (typically APC for web requests, and EmptyBagOStuff in CLI mode). Not replicated to the other servers.
ObjectCache::getLocalClusterInstance() Purpose: Memory storage for per-cluster coordination and tracking. A typical use case would be a rate limit counter or cache regeneration mutex. Stored centrally within the local data-center. Not replicated to other DCs. Configured by $wgMainCacheType.
ObjectCache::getMainStashInstance() Purpose: Ephemeral global storage. Stored centrally within the primary data-center. Changes are applied there first and replicated to other DCs (best-effort). To retrieve the latest value (e.g. not from a slave), use BagOStuff::READ_LATEST. This store may be subject to LRU style evictions.
ObjectCache::getInstance( $cacheType ) Purpose: Special cases (like tiered memory/disk caches). Get a specific cache type by key in $wgObjectCaches.

All the above cache instances (BagOStuff and WANObjectCache) have their makeKey() method scoped to the current wiki ID. Use makeGlobalKey() to avoid this scoping when using keys that need to be shared amongst wikis.

Definition at line 81 of file ObjectCache.php.

Member Function Documentation

static ObjectCache::clear ( )

static

Clear all the cached instances.

Definition at line 381 of file ObjectCache.php.

Referenced by MediaWiki\MediaWikiServices\disableStorageBackend(), MediaWikiTestCase\doLightweightServiceReset(), and ForkController\prepareEnvironment().

static ObjectCache::getDefaultKeyspace ( )

static

Get the default keyspace for this wiki.

This is either the value of the CachePrefix configuration variable, or (if the former is unset) the DBname configuration variable, with DBprefix (if defined).

Returns: string

Definition at line 143 of file ObjectCache.php.

References $wgCachePrefix, global, and wfWikiID().

static ObjectCache::getInstance ( $id )

static

Get a cached instance of the specified type of cache object.

Parameters

string $id A key in $wgObjectCaches.

Returns: BagOStuff

Definition at line 93 of file ObjectCache.php.

Referenced by MediaWiki\Session\SessionManager\__construct(), Installer\__construct(), Preprocessor\cacheGetTree(), Preprocessor\cacheSetTree(), LanguageConverter\loadTables(), wfGetCache(), wfGetMainCache(), wfGetMessageCacheStorage(), and wfGetParserCacheStorage().

static ObjectCache::getLocalClusterInstance ( )

static

Get the main cluster-local cache object.

Since: 1.27

Returns: BagOStuff

Definition at line 336 of file ObjectCache.php.

References global.

Referenced by LoadMonitorMySQL\__construct(), MediaWiki\Auth\ThrottlePreAuthenticationProvider\__construct(), MediaWiki\Auth\Throttler\__construct(), SwiftFileBackend\__construct(), Pingback\acquireLock(), LoginFormPreAuthManager\addNewAccountInternal(), MediaWiki\Session\SessionManager\autoCreateUser(), MediaWiki\Auth\AuthManager\autoCreateUser(), ApiStashEdit\checkCache(), LoginFormPreAuthManager\clearLoginThrottle(), MediaWiki\Auth\AuthManager\continueAccountCreation(), FileCacheBase\getMissesRecent(), LoginFormPreAuthManager\incrementLoginThrottle(), FileCacheBase\incrMissesRecent(), ApiStashEdit\parseAndStash(), User\pingLimiter(), JobQueueGroup\queuesHaveJobs(), ResourceLoaderModule\saveFileDependencies(), MediaWiki\Auth\AuthManagerTest\testAutoAccountCreation(), MediaWiki\Session\SessionManagerTest\testAutoCreateUser(), MediaWiki\Auth\AuthManagerTest\testContinueAccountCreation(), GlobalTest\testWfForeignMemcKey(), GlobalTest\testWfGlobalCacheKey(), GlobalTest\testWfMemcKey(), WikiPage\triggerOpportunisticLinksUpdate(), wfForeignMemcKey(), wfGenerateThumbnail(), wfGlobalCacheKey(), and wfMemcKey().

static ObjectCache::getLocalServerInstance ( $fallback = CACHE_NONE )

static

Factory function for CACHE_ACCEL (referenced from DefaultSettings.php)

This will look for any APC style server-local cache. A fallback cache can be specified if none is found.

// Direct calls
ObjectCache::getLocalServerInstance( $fallbackType );

// From $wgObjectCaches via newFromParams()
ObjectCache::getLocalServerInstance( array( 'fallback' => $fallbackType ) );

Parameters

int | string | array $fallback Fallback cache or parameter map with 'fallback'

Returns: BagOStuff

Exceptions

MWException

Since: 1.27

Definition at line 261 of file ObjectCache.php.

References $fallback, CACHE_NONE, and wfIniGetBool().

Referenced by FileContentsHasher\__construct(), LoadMonitorMySQL\__construct(), DBLockManager\__construct(), ExtensionRegistry\__construct(), LoadBalancer\__construct(), SwiftFileBackend\__construct(), MessageCache\__construct(), DatabaseBase\__construct(), ResourceLoaderFileModule\compileLessFile(), ResourceLoader\filter(), IcuCollation\getFirstLetterData(), DateFormatter\getInstance(), TransformationalImageHandler\getMagickVersion(), UIDGenerator\getSequentialPerNodeIDs(), TemplateParser\getTemplate(), MWCryptHKDF\singleton(), and wfIsBadImage().

static ObjectCache::getMainStashInstance ( )

static

Get the cache object for the main stash.

Stash objects are BagOStuff instances suitable for storing light weight data that is not canonically stored elsewhere (such as RDBMS). Stashes should be configured to propagate changes to all data-centers.

Callers should be prepared for:

a) Writes to be slower in non-"primary" (e.g. HTTP GET/HEAD only) DCs
b) Reads to be eventually consistent, e.g. for get()/getMulti() In general, this means avoiding updates on idempotent HTTP requests and avoiding an assumption of perfect serializability (or accepting anomalies). Reads may be eventually consistent or data might rollback as nodes flap. Callers can use BagOStuff:READ_LATEST to see the latest available data.

Returns: BagOStuff

Since: 1.26

Definition at line 372 of file ObjectCache.php.

References $wgMainStash, and global.

Referenced by SiteStatsUpdate\adjustPending(), WikiPage\doDeleteArticleReal(), SiteStatsUpdate\getPendingDeltas(), UploadBase\getSessionStatus(), LBFactory\newChronologyProtector(), SiteStatsUpdate\removePendingDeltas(), UploadBase\setSessionStatus(), and Article\showMissingArticle().

static ObjectCache::getMainWANInstance ( )

static

Get the main WAN cache object.

Since: 1.26

Returns: WANObjectCache

Definition at line 348 of file ObjectCache.php.

References $wgMainWANCache, and global.

Referenced by JobQueueDB\__construct(), MessageBlobStore\__construct(), LoadBalancer\__construct(), MessageCache\__construct(), Skin\buildSidebar(), FeedUtils\checkPurge(), LocalRepo\checkRedirect(), User\clearSharedCache(), FormatMetadata\fetchExtendedMetadata(), FileBackendGroup\get(), JobQueueGroup\getCachedConfigVar(), ForeignDBFile\getDescriptionText(), File\getDescriptionText(), DifferenceEngine\getDiffBody(), DjVuHandler\getDimensionInfo(), ApiHelp\getHelp(), BacklinkCache\getNumLinks(), ForeignAPIRepo\getThumbUrlFromCache(), User\getTouched(), ForeignAPIRepo\httpGetCached(), InfoAction\invalidateCache(), LocalFile\invalidateCache(), LocalRepo\invalidateImageRedirect(), Block\isWhitelistedFromAutoblocks(), ChangeTags\listExplicitlyDefinedTags(), ChangeTags\listExtensionActivatedTags(), ChangeTags\listExtensionDefinedTags(), ChangesFeed\loadFromCache(), LocalFile\loadFromCache(), User\loadFromCache(), AjaxResponse\loadFromMemcached(), Revision\loadText(), ApiMain\makeHelpMsg(), SiteStats\numberingroup(), InfoAction\pageCounts(), BacklinkCache\partition(), User\purge(), ForeignAPIFile\purgeDescriptionPage(), Article\purgePatrolFooterCache(), ChangeTags\purgeTagCacheAll(), ChangeTags\purgeTagUsageCache(), ForeignAPIFile\purgeThumbnails(), ParserTest\runTest(), ChangesFeed\saveToCache(), LocalFile\saveToCache(), MediaWikiTestCase\setUp(), Article\showPatrolFooter(), AjaxResponse\storeInMemcached(), ChangeTags\tagUsageStatistics(), User\touch(), and ResourceLoaderModule\validateScriptFile().

static ObjectCache::getWANInstance ( $id )

static

Get a cached instance of the specified type of WAN cache object.

Since: 1.26

Parameters

string $id A key in $wgWANObjectCaches.

Returns: WANObjectCache

Definition at line 108 of file ObjectCache.php.

Referenced by WANObjectCacheTest\setUp().

static ObjectCache::newAccelerator	(	$params = `[]`,
		$fallback = `null`
	)

static

Parameters

array	$params	[optional] Array key 'fallback' for $fallback.
int \| string	$fallback	Fallback cache, e.g. (CACHE_NONE, "hash") (since 1.24)

Returns: BagOStuff

Deprecated:: 1.27

Definition at line 285 of file ObjectCache.php.

References $fallback, and $params.

Referenced by LanguageConverter\convertNamespace().

static ObjectCache::newAnything ( $params )

static

Factory function for CACHE_ANYTHING (referenced from DefaultSettings.php)

CACHE_ANYTHING means that stuff has to be cached, not caching is not an option. If a caching method is configured for any of the main caches ($wgMainCacheType, $wgMessageCacheType, $wgParserCacheType), then CACHE_ANYTHING will effectively be an alias to the configured cache choice for that. If no cache choice is configured (by default $wgMainCacheType is CACHE_NONE), then CACHE_ANYTHING will forward to CACHE_DB.

Parameters

array $params