Cache messages that are defined by MediaWiki-namespace pages or by hooks. More...

Inherits LoggerAwareInterface.

Collaboration diagram for MessageCache:

Public Member Functions
	__construct (WANObjectCache $wanCache, BagOStuff $mainCache, BagOStuff $serverCache, Language $contLang, LanguageConverterFactory $langConverterFactory, LoggerInterface $logger, ServiceOptions $options, LocalisationCache $localisationCache, LanguageNameUtils $languageNameUtils, LanguageFallback $languageFallback, HookContainer $hookContainer, MessageParser $messageParser)

	clear ()
	Clear all stored messages in global and local cache.

	disable ( $logReason='')
	Disable loading of messages from the MediaWiki namespace.

	enable ()
	Re-enable the MessageCache if it was disabled by a call to disable()

	figureMessage ( $key)
	Given a title string possibly containing a slash, determine the message key and language code.

	get ( $key, $useDB=true, $language=null, $info=null)
	Get a message from either the content language or the user language.

	getAllMessageKeys ( $code)
	Get all message keys stored in the message cache for a given language.

	getCheckKey ( $code)

	getMsgFromNamespace ( $title, $code)
	Get a message from the MediaWiki namespace, with caching.

	isDisabled ()
	Whether DB/cache usage is disabled for determining messages.

	normalizeKey (string $key)
	Normalize message key input.

	parse ( $text, ?PageReference $page=null, $linestart=true, $interface=false, $language=null)

	parseWithPostprocessing (string $text, PageReference $contextPage, bool $linestart=true, bool $interface=false, $language=null)

	refreshAndReplaceInternal (string $code, array $replacements)

	replace ( $title, $text)
	Update the cache as necessary when a message page is changed.

	setLogger (LoggerInterface $logger)

	transform ( $message, $interface=false, $language=null, ?PageReference $page=null)

	updateMessageOverride ( $page, ?Content $content=null)
	Purge message caches when a MediaWiki: page is created, updated, or deleted.

Public Attributes
const	CONSTRUCTOR_OPTIONS
	Options to be included in the ServiceOptions.

const	MAX_REQUEST_LANGUAGES = 10
	The size of the MapCacheLRU which stores message data.

Detailed Description

Cache messages that are defined by MediaWiki-namespace pages or by hooks.

Definition at line 63 of file MessageCache.php.

Constructor & Destructor Documentation

◆ __construct()

MessageCache::__construct	(	WANObjectCache	$wanCache,
		BagOStuff	$mainCache,
		BagOStuff	$serverCache,
		Language	$contLang,
		LanguageConverterFactory	$langConverterFactory,
		LoggerInterface	$logger,
		ServiceOptions	$options,
		LocalisationCache	$localisationCache,
		LanguageNameUtils	$languageNameUtils,
		LanguageFallback	$languageFallback,
		HookContainer	$hookContainer,
		MessageParser	$messageParser )

Access: internal: For use by ServiceWiring

Parameters

WANObjectCache	$wanCache
BagOStuff	$mainCache
BagOStuff	$serverCache
Language	$contLang	Content language of site
LanguageConverterFactory	$langConverterFactory
LoggerInterface	$logger
ServiceOptions	$options
LocalisationCache	$localisationCache
LanguageNameUtils	$languageNameUtils
LanguageFallback	$languageFallback
HookContainer	$hookContainer
MessageParser	$messageParser

Definition at line 180 of file MessageCache.php.

References MediaWiki\Config\ServiceOptions\assertRequiredOptions(), disable(), MediaWiki\Config\ServiceOptions\get(), MediaWiki\Language\Language\getCode(), and MediaWiki\Languages\LanguageConverterFactory\getLanguageConverter().

Member Function Documentation

◆ clear()

MessageCache::clear ( )

Clear all stored messages in global and local cache.

Mainly used after a mass rebuild

Definition at line 1524 of file MessageCache.php.

◆ disable()

MessageCache::disable ( $logReason = '' )

Disable loading of messages from the MediaWiki namespace.

Use the LocalisationCache only.

Parameters

string $logReason If given, log a message including this reason

Definition at line 1487 of file MessageCache.php.

Referenced by __construct().

◆ enable()

MessageCache::enable ( )

Re-enable the MessageCache if it was disabled by a call to disable()

Definition at line 1497 of file MessageCache.php.

◆ figureMessage()

MessageCache::figureMessage ( $key )

Given a title string possibly containing a slash, determine the message key and language code.

No initial letter case normalisation is done.

Parameters

string $key

Returns: array

Definition at line 1539 of file MessageCache.php.

Referenced by replace().

◆ get()

MessageCache::get	(	$key,
		$useDB = true,
		$language = null,
		$info = null )

Get a message from either the content language or the user language.

First, assemble a list of languages to attempt getting the message from. This chain begins with the requested language and its fallbacks and then continues with the content language and its fallbacks. For each language in the chain, the following process will occur (in this order):

If a language-specific override, i.e., [[MW:msg/lang]], is available, use that. Note: for the content language, there is no /lang subpage.
Fetch from LocalisationCache (the i18n JSON file store).
If available, check the database for fallback language overrides.

This process provides a number of guarantees. When changing this code, make sure all of these guarantees are preserved.

If the requested language is not the content language, then the CDB cache for that specific language will take precedence over the root database page ([[MW:msg]]).
Fallbacks will be just that: fallbacks. A fallback language will never be reached if the message is available anywhere in the language for which it is a fallback.

Parameters

string	$key	The message key
bool	$useDB	If true, look for the message in the DB, false to use only the LocalisationCache.
bool \| string \| Language \| null	$language	Code of the language to get the message for. This should be a string or null in new code. If null is given, the content language will be used.
MessageInfo \| null	$info	If a default-constructed MessageInfo is passed, it will be populated with information about the retrieved message.

Returns: string|false False if the message doesn't exist, otherwise the message (which can be empty)

Definition at line 995 of file MessageCache.php.

◆ getAllMessageKeys()

MessageCache::getAllMessageKeys ( $code )

Get all message keys stored in the message cache for a given language.

If $code is the content language code, this will return all message keys for which MediaWiki:msgkey exists. If $code is another language code, this will ONLY return message keys for which MediaWiki:msgkey/$code exists.

Parameters

string $code Language code

Returns: string[]|null Array of message keys

Definition at line 1568 of file MessageCache.php.

◆ getCheckKey()

MessageCache::getCheckKey ( $code )

Parameters

string $code Language code

Returns: string WAN cache key usable as a "check key" against language page edits

Definition at line 1609 of file MessageCache.php.

Referenced by refreshAndReplaceInternal().

◆ getMsgFromNamespace()

MessageCache::getMsgFromNamespace	(		$title,
			$code )

Get a message from the MediaWiki namespace, with caching.

The key must first be converted to two-part lang/msg form if necessary.

Unlike self::get(), this function doesn't resolve fallback chains, and some callers require this behavior. LanguageConverter::parseCachedTable() and self::get() are some examples in core.

Parameters

string	$title	Message cache key with the initial uppercase letter
string	$code	Code denoting the language to try

Returns: string|false The message, or false if it does not exist or on error

Definition at line 1280 of file MessageCache.php.

◆ isDisabled()

MessageCache::isDisabled ( )

Whether DB/cache usage is disabled for determining messages.

If so, this typically indicates either:

a) load() failed to find a cached copy nor query the DB
b) we are in a special context or error mode that cannot use the DB

If the DB is ignored, any derived HTML output or cached objects may be wrong. To avoid long-term cache pollution, TTLs can be adjusted accordingly.

Returns: bool

Since: 1.27

Definition at line 1515 of file MessageCache.php.

◆ normalizeKey()

MessageCache::normalizeKey ( string $key )

Normalize message key input.

Parameters

string $key Input message key to be normalized

Returns: string Normalized message key

Definition at line 950 of file MessageCache.php.

◆ parse()

MessageCache::parse	(		$text,
		?PageReference	$page = null,
			$linestart = true,
			$interface = false,
			$language = null )

Deprecated: since 1.44 use MessageParser::parseWithoutPostprocessing()

Parameters

string	$text
PageReference \| null	$page
bool	$linestart	Whether this is at the start of a line
bool	$interface	Whether this is an interface message
Language \| StubUserLang \| string \| null	$language	Language code

Returns: ParserOutput

Definition at line 1454 of file MessageCache.php.

References $wgTitle, and NS_SPECIAL.

◆ parseWithPostprocessing()

MessageCache::parseWithPostprocessing	(	string	$text,
		PageReference	$contextPage,
		bool	$linestart = true,
		bool	$interface = false,
			$language = null )

Deprecated: since 1.44 use MessageParser::parse()

Access: internal

Parameters

string	$text
PageReference	$contextPage
bool	$linestart	Whether this should be parsed in start-of-line context (defaults to true)
bool	$interface	Whether this is an interface message (defaults to false)
Language \| StubUserLang \| string \| null	$language	Language code

Returns: ParserOutput

Definition at line 1434 of file MessageCache.php.

◆ refreshAndReplaceInternal()

MessageCache::refreshAndReplaceInternal	(	string	$code,
		array	$replacements )

Access: internal: Entry point for MessageCacheUpdate

Parameters

string	$code
array[]	$replacements	List of (title, message key) pairs

Definition at line 750 of file MessageCache.php.

References MapCacheLRU\get(), getCheckKey(), and NS_MEDIAWIKI.

◆ replace()

MessageCache::replace	(		$title,
			$text )

Update the cache as necessary when a message page is changed.

Parameters

string	$title	Message cache key with the initial uppercase letter
string \| false	$text	New contents of the page (false if deleted)

Definition at line 718 of file MessageCache.php.

References figureMessage().

◆ setLogger()

MessageCache::setLogger ( LoggerInterface $logger )

Definition at line 219 of file MessageCache.php.

◆ transform()

MessageCache::transform	(		$message,
			$interface = false,
			$language = null,
		?PageReference	$page = null )

Deprecated: since 1.44 use MessageParser::transform()

Parameters

string	$message
bool	$interface
Language \| null	$language
PageReference \| null	$page

Returns: string

Definition at line 1416 of file MessageCache.php.

◆ updateMessageOverride()

MessageCache::updateMessageOverride	(		$page,
		?Content	$content = null )

Purge message caches when a MediaWiki: page is created, updated, or deleted.

Parameters

PageIdentity	$page	Message page
Content \| null	$content	New content for edit/create, null on deletion

Since: 1.29

Definition at line 1594 of file MessageCache.php.

Member Data Documentation

◆ CONSTRUCTOR_OPTIONS

const MessageCache::CONSTRUCTOR_OPTIONS

Initial value:

= [
        MainConfigNames::UseDatabaseMessages,
        MainConfigNames::MaxMsgCacheEntrySize,
        MainConfigNames::AdaptiveMessageCache,
        MainConfigNames::UseXssLanguage,
        MainConfigNames::RawHtmlMessages,
    ]

Options to be included in the ServiceOptions.

Definition at line 67 of file MessageCache.php.

◆ MAX_REQUEST_LANGUAGES

const MessageCache::MAX_REQUEST_LANGUAGES = 10

The size of the MapCacheLRU which stores message data.

The maximum number of languages which can be efficiently loaded in a given request.

Definition at line 84 of file MessageCache.php.

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

includes/language/MessageCache.php

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ clear()

◆ disable()

◆ enable()

◆ figureMessage()

◆ get()

◆ getAllMessageKeys()

◆ getCheckKey()

◆ getMsgFromNamespace()

◆ isDisabled()

◆ normalizeKey()

◆ parse()

◆ parseWithPostprocessing()

◆ refreshAndReplaceInternal()

◆ replace()

◆ setLogger()

◆ transform()

◆ updateMessageOverride()

Member Data Documentation

◆ CONSTRUCTOR_OPTIONS

◆ MAX_REQUEST_LANGUAGES