Set options of the Parser. More...

Collaboration diagram for ParserOptions:

[legend]

Public Member Functions
	__construct (UserIdentity $user, $lang=null)

	addExtraKey ( $key)
	Extra key that should be present in the parser cache key.

	disableContentConversion ( $x=true)
	Whether content conversion should be disabled.

	disableTitleConversion ( $x=true)
	Whether title conversion should be disabled.

	enableLimitReport ( $x=true)
	Enable limit report in an HTML comment on output.

	getAllowExternalImages ()
	Allow all external images inline?

	getAllowExternalImagesFrom ()
	External images to allow.

	getAllowSpecialInclusion ()
	Allow inclusion of special pages?

	getAllowUnsafeRawHtml ()
	If the wiki is configured to allow raw html ($wgRawHtml = true) is it allowed in the specific case of parsing this page.

	getCleanSignatures ()
	Clean up signature texts?

	getCurrentRevisionRecordCallback ()
	Callback for current revision fetching; first argument to call_user_func().

	getDateFormat ()
	Date format index.

	getDisableContentConversion ()
	Whether content conversion should be disabled.

	getDisableTitleConversion ()
	Whether title conversion should be disabled.

	getEnableImageWhitelist ()
	Use the on-wiki external image whitelist?

	getEnableLimitReport ()
	Enable limit report in an HTML comment on output.

	getExpensiveParserFunctionLimit ()
	Maximum number of calls per parse to expensive parser functions.

	getExternalLinkTarget ()
	Target attribute for external links.

	getInterfaceMessage ()
	Parsing an interface message?

	getInterwikiMagic ()
	Whether to extract interlanguage links.

	getIsPreview ()
	Parsing the page for a "preview" operation?

	getIsPrintable ()
	Parsing the printable version of the page?

	getIsSectionPreview ()
	Parsing the page for a "preview" operation on a single section?

	getMagicISBNLinks ()
	Are magic ISBN links enabled?

	getMagicPMIDLinks ()
	Are magic PMID links enabled?

	getMagicRFCLinks ()
	Are magic RFC links enabled?

	getMaxIncludeSize ()
	Maximum size of template expansions, in bytes.

	getMaxPPExpandDepth ()
	Maximum recursion depth in PPFrame::expand()

	getMaxPPNodeCount ()
	Maximum number of nodes touched by PPFrame::expand()

	getMaxTemplateDepth ()
	Maximum recursion depth for templates within templates.

	getNumberHeadings ()
	Automatically number headings?

	getOption ( $name)
	Fetch an option and track that is was accessed.

	getPreSaveTransform ()
	Transform wiki markup when saving the page?

	getRedirectTarget ()
	Get the previously-set redirect target.

	getRemoveComments ()
	Remove HTML comments.

	getSpeculativePageId ()
	A guess for {{PAGEID}}, calculated using the callback provided via setSpeculativeRevPageCallback().

	getSpeculativeRevId ()
	A guess for {{REVISIONID}}, calculated using the callback provided via setSpeculativeRevIdCallback().

	getStubThreshold ()
	Thumb size preferred by the user.

	getTargetLanguage ()
	Target language for the parse.

	getTemplateCallback ()
	Callback for template fetching; first argument to call_user_func().

	getThumbSize ()
	Thumb size preferred by the user.

	getTimestamp ()
	Timestamp used for {{CURRENTDAY}} etc.

	getUser ()
	Current user.

	getUserIdentity ()
	Get the identity of the user for whom the parse is made.

	getUserLang ()
	Same as getUserLangObj() but returns a string instead.

	getUserLangObj ()
	Get the user language used by the parser for this page and split the parser cache.

	getWrapOutputClass ()
	Class to use to wrap output from Parser::parse()

	isSafeToCache (array $usedOptions=null)
	Test whether these options are safe to cache.

	matches (ParserOptions $other)
	Check if these options match that of another options set.

	matchesForCacheKey (ParserOptions $other)

	optionsHash ( $forOptions, $title=null)
	Generate a hash string with the values set on these ParserOptions for the keys given in the array.

	optionUsed ( $optionName)
	Called when an option is accessed.

	registerWatcher ( $callback)
	Registers a callback for tracking which ParserOptions which are used.

	setAllowExternalImages ( $x)
	Allow all external images inline?

	setAllowExternalImagesFrom ( $x)
	External images to allow.

	setAllowSpecialInclusion ( $x)
	Allow inclusion of special pages?

	setAllowUnsafeRawHtml ( $x)
	If the wiki is configured to allow raw html ($wgRawHtml = true) is it allowed in the specific case of parsing this page.

	setCleanSignatures ( $x)
	Clean up signature texts?

	setCurrentRevisionRecordCallback ( $x)
	Callback for current revision fetching; first argument to call_user_func().

	setDateFormat ( $x)
	Date format index.

	setEnableImageWhitelist ( $x)
	Use the on-wiki external image whitelist?

	setExpensiveParserFunctionLimit ( $x)
	Maximum number of calls per parse to expensive parser functions.

	setExternalLinkTarget ( $x)
	Target attribute for external links.

	setInterfaceMessage ( $x)
	Parsing an interface message?

	setInterwikiMagic ( $x)
	Specify whether to extract interlanguage links.

	setIsPreview ( $x)
	Parsing the page for a "preview" operation?

	setIsPrintable ( $x)
	Parsing the printable version of the page?

	setIsSectionPreview ( $x)
	Parsing the page for a "preview" operation on a single section?

	setMaxIncludeSize ( $x)
	Maximum size of template expansions, in bytes.

	setMaxPPNodeCount ( $x)
	Maximum number of nodes touched by PPFrame::expand()

	setMaxTemplateDepth ( $x)
	Maximum recursion depth for templates within templates.

	setNumberHeadings ( $x)
	Automatically number headings?

	setOption ( $name, $value)
	Set an option, generically.

	setPreSaveTransform ( $x)
	Transform wiki markup when saving the page?

	setRedirectTarget ( $title)
	Note that setting or changing this does not make the page a redirect or change its target, it merely records the information for reference during the parse.

	setRemoveComments ( $x)
	Remove HTML comments.

	setSpeculativePageIdCallback ( $x)
	Callback to generate a guess for {{PAGEID}}.

	setSpeculativeRevIdCallback ( $x)
	Callback to generate a guess for {{REVISIONID}}.

	setStubThreshold ( $x)
	Thumb size preferred by the user.

	setTargetLanguage ( $x)
	Target language for the parse.

	setTemplateCallback ( $x)
	Callback for template fetching; first argument to call_user_func().

	setThumbSize ( $x)
	Thumb size preferred by the user.

	setTidy ( $x)
	Use tidy to cleanup output HTML?

	setTimestamp ( $x)
	Timestamp used for {{CURRENTDAY}} etc.

	setupFakeRevision ( $title, $content, $user)
	Sets a hook to force that a page exists, and sets a current revision callback to return a revision with custom content when the current revision of the page is requested.

	setUserLang ( $x)
	Set the user language used by the parser for this page and split the parser cache.

	setWrapOutputClass ( $className)
	CSS class to use to wrap output from Parser::parse()

Static Public Member Functions
static	allCacheVaryingOptions ()
	Return all option keys that vary the options hash.

static	clearStaticCache ()
	Reset static caches.

static	getLazyOptions ()
	Get lazy-loaded options.

static	newCanonical ( $context, $userLang=null)
	Creates a "canonical" ParserOptions object.

static	newFromAnon ()
	Get a ParserOptions object for an anonymous user.

static	newFromContext (IContextSource $context)
	Get a ParserOptions object from a IContextSource object.

static	newFromUser ( $user)
	Get a ParserOptions object from a given user.

static	newFromUserAndLang (UserIdentity $user, Language $lang)
	Get a ParserOptions object from a given user and language.

Protected Member Functions
	setOptionLegacy ( $name, $value)
	Legacy implementation.

Private Member Functions
	initialiseFromUser (UserIdentity $user, Language $lang)
	Get user options.

	lazyLoadOption ( $name)

	nullifyLazyOption (array $options)
	Resets lazy loaded options to null in the provided $options array.

	optionToString ( $value)
	Convert an option to a string value.

Static Private Member Functions
static	getCacheVaryingOptionsHash ()
	Get cache varying options, with the name of the option in the key, and a boolean in the value which indicates whether the cache is indeed varied.

static	getCanonicalOverrides ()
	Get "canonical" non-default option values.

static	getDefaults ()
	Get default option values.

static	initDateFormat (ParserOptions $popt)
	Lazy initializer for dateFormat.

static	initSpeculativePageId (ParserOptions $popt)
	Callback registered with ParserOptions::$lazyOptions, triggered by getSpeculativePageId().

static	initSpeculativeRevId (ParserOptions $popt)
	Callback registered with ParserOptions::$lazyOptions, triggered by getSpeculativeRevId().

Private Attributes
	$mExtraKey = ''
	Appended to the options hash.

string null	$mTimestamp
	Timestamp used for {{CURRENTDAY}} etc.

UserIdentity	$mUser
	Stored user object.

callable null	$onAccessCallback = null
	Function to be called when an option is accessed.

array	$options
	Current values for all options that are relevant for caching.

Title null	$redirectTarget = null
	If the page being parsed is a redirect, this should hold the redirect target.

Static Private Attributes
static array null	$cacheVaryingOptionsHash = null
	Specify options that are included in the cache key.

static array	$callbacks
	Specify pseudo-options that are actually callbacks.

static array null	$defaults = null
	Default values for all options that are relevant for caching.

static array	$initialCacheVaryingOptionsHash
	Initial inCacheKey options (before hook)

static callable[]	$initialLazyOptions
	Initial lazy-loaded options (before hook)

static callable[] null	$lazyOptions = null
	Lazy-loaded options.

Detailed Description

Set options of the Parser.

How to add an option in core:

Add it to one of the arrays in ParserOptions::setDefaults()
If necessary, add an entry to ParserOptions::$inCacheKey
Add a getter and setter in the section for that.

How to add an option in an extension:

Use the 'ParserOptionsRegister' hook to register it.
Where necessary, use $popt->getOption() and $popt->setOption() to access it.

Definition at line 45 of file ParserOptions.php.

Constructor & Destructor Documentation

◆ __construct()

ParserOptions::__construct	(	UserIdentity	$user,
			$lang = `null`
	)

Warning: For interaction with the parser cache, use WikiPage::makeParserOptions() or ParserOptions::newCanonical() instead.

Parameters

UserIdentity	$user
Language \| null	$lang

Definition at line 1057 of file ParserOptions.php.

References $lang, $wgLang, and StubObject\unstub().

Member Function Documentation

◆ addExtraKey()

ParserOptions::addExtraKey ( $key )

Extra key that should be present in the parser cache key.

Warning: Consider registering your additional options with the ParserOptionsRegister hook instead of using this method.

Parameters

string $key

Definition at line 1025 of file ParserOptions.php.

◆ allCacheVaryingOptions()

static ParserOptions::allCacheVaryingOptions ( )

static

Return all option keys that vary the options hash.

Since: 1.30

Returns: string[]

Definition at line 1380 of file ParserOptions.php.

◆ clearStaticCache()

static ParserOptions::clearStaticCache ( )

static

Reset static caches.

Access: internal: For testing

Definition at line 1157 of file ParserOptions.php.

◆ disableContentConversion()

ParserOptions::disableContentConversion ( $x = true )

Whether content conversion should be disabled.

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 574 of file ParserOptions.php.

◆ disableTitleConversion()

ParserOptions::disableTitleConversion ( $x = true )

Whether title conversion should be disabled.

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 591 of file ParserOptions.php.

◆ enableLimitReport()

ParserOptions::enableLimitReport ( $x = true )

Enable limit report in an HTML comment on output.

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 521 of file ParserOptions.php.

Referenced by ApiParse\tweakParserOptions().

◆ getAllowExternalImages()

ParserOptions::getAllowExternalImages ( )

Allow all external images inline?

Returns: bool

Definition at line 269 of file ParserOptions.php.

◆ getAllowExternalImagesFrom()

ParserOptions::getAllowExternalImagesFrom ( )

External images to allow.

When self::getAllowExternalImages() is false

Returns: string|string[] URLs to allow

Definition at line 292 of file ParserOptions.php.

◆ getAllowSpecialInclusion()

ParserOptions::getAllowSpecialInclusion ( )

Allow inclusion of special pages?

Returns: bool

Definition at line 352 of file ParserOptions.php.

◆ getAllowUnsafeRawHtml()

ParserOptions::getAllowUnsafeRawHtml ( )

If the wiki is configured to allow raw html ($wgRawHtml = true) is it allowed in the specific case of parsing this page.

This is meant to disable unsafe parser tags in cases where a malicious user may control the input to the parser.

Note: This is expected to be true for normal pages even if the wiki has $wgRawHtml disabled in general. The setting only signifies that raw html would be unsafe in the current context provided that raw html is allowed at all.

Since: 1.29

Returns: bool

Definition at line 819 of file ParserOptions.php.

◆ getCacheVaryingOptionsHash()

static ParserOptions::getCacheVaryingOptionsHash ( )

staticprivate

Get cache varying options, with the name of the option in the key, and a boolean in the value which indicates whether the cache is indeed varied.

See also: self::allCacheVaryingOptions()

Returns: array

Definition at line 203 of file ParserOptions.php.

◆ getCanonicalOverrides()

static ParserOptions::getCanonicalOverrides ( )

staticprivate

Get "canonical" non-default option values.

See also: self::newCanonical

Warning: If you change the override for an existing option, all existing parser cache entries will be invalid. To avoid bugs, you'll need to handle that somehow (e.g. with the RejectParserCacheValue hook) because MediaWiki won't do it for you.

Returns: array

Definition at line 1254 of file ParserOptions.php.

References $wgEnableParserLimitReporting.

◆ getCleanSignatures()

ParserOptions::getCleanSignatures ( )

Clean up signature texts?

See also: Parser::cleanSig

Returns: bool

Definition at line 530 of file ParserOptions.php.

◆ getCurrentRevisionRecordCallback()

ParserOptions::getCurrentRevisionRecordCallback ( )

Callback for current revision fetching; first argument to call_user_func().

Access: internal

Since: 1.35

Returns: callable

Definition at line 867 of file ParserOptions.php.

◆ getDateFormat()

ParserOptions::getDateFormat ( )

Date format index.

Returns: string

Definition at line 705 of file ParserOptions.php.

◆ getDefaults()

static ParserOptions::getDefaults ( )

staticprivate

Get default option values.

Warning: If you change the default for an existing option (unless it's being overridden by self::getCanonicalOverrides()), all existing parser cache entries will be invalid. To avoid bugs, you'll need to handle that somehow (e.g. with the RejectParserCacheValue hook) because MediaWiki won't do it for you.

Returns: array

Definition at line 1175 of file ParserOptions.php.

References $userOptionsLookup, $wgAllowExternalImages, $wgAllowExternalImagesFrom, $wgAllowSpecialInclusion, $wgCleanSignatures, $wgEnableImageWhitelist, $wgEnableMagicLinks, $wgExpensiveParserFunctionLimit, $wgExternalLinkTarget, $wgInterwikiMagic, $wgMaxArticleSize, $wgMaxPPExpandDepth, $wgMaxPPNodeCount, and $wgMaxTemplateDepth.

◆ getDisableContentConversion()

ParserOptions::getDisableContentConversion ( )

Whether content conversion should be disabled.

Returns: bool

Definition at line 565 of file ParserOptions.php.

◆ getDisableTitleConversion()

ParserOptions::getDisableTitleConversion ( )

Whether title conversion should be disabled.

Returns: bool

Definition at line 582 of file ParserOptions.php.

Referenced by Parser\parse().

◆ getEnableImageWhitelist()

ParserOptions::getEnableImageWhitelist ( )

Use the on-wiki external image whitelist?

Returns: bool

Definition at line 315 of file ParserOptions.php.

◆ getEnableLimitReport()

ParserOptions::getEnableLimitReport ( )

Enable limit report in an HTML comment on output.

Returns: bool

Definition at line 512 of file ParserOptions.php.

◆ getExpensiveParserFunctionLimit()

ParserOptions::getExpensiveParserFunctionLimit ( )

Maximum number of calls per parse to expensive parser functions.

Since: 1.20

Returns: int

Definition at line 475 of file ParserOptions.php.

◆ getExternalLinkTarget()

ParserOptions::getExternalLinkTarget ( )

Target attribute for external links.

Returns: string

Definition at line 548 of file ParserOptions.php.

◆ getInterfaceMessage()

ParserOptions::getInterfaceMessage ( )

Parsing an interface message?

Returns: bool

Definition at line 381 of file ParserOptions.php.

◆ getInterwikiMagic()

ParserOptions::getInterwikiMagic ( )

Whether to extract interlanguage links.

When true, interlanguage links will be returned by ParserOutput::getLanguageLinks() instead of generating link HTML.

Returns: bool

Definition at line 252 of file ParserOptions.php.

◆ getIsPreview()

ParserOptions::getIsPreview ( )

Parsing the page for a "preview" operation?

Returns: bool

Definition at line 637 of file ParserOptions.php.

◆ getIsPrintable()

ParserOptions::getIsPrintable ( )

Parsing the printable version of the page?

Returns: bool

Definition at line 671 of file ParserOptions.php.

◆ getIsSectionPreview()

ParserOptions::getIsSectionPreview ( )

Parsing the page for a "preview" operation on a single section?

Returns: bool

Definition at line 654 of file ParserOptions.php.

◆ getLazyOptions()

static ParserOptions::getLazyOptions ( )

static

Get lazy-loaded options.

This array should be initialised by the constructor. The return type hint is used as an assertion to ensure this has happened and to coerce the type for static analysis.

Access: internal: Public for testing only

Returns: array

Definition at line 186 of file ParserOptions.php.

Referenced by nullifyLazyOption().

◆ getMagicISBNLinks()

ParserOptions::getMagicISBNLinks ( )

Are magic ISBN links enabled?

Since: 1.28

Returns: bool

Definition at line 783 of file ParserOptions.php.

◆ getMagicPMIDLinks()

ParserOptions::getMagicPMIDLinks ( )

Are magic PMID links enabled?

Since: 1.28

Returns: bool

Definition at line 792 of file ParserOptions.php.

◆ getMagicRFCLinks()

ParserOptions::getMagicRFCLinks ( )

Are magic RFC links enabled?

Since: 1.28

Returns: bool

Definition at line 801 of file ParserOptions.php.

◆ getMaxIncludeSize()

ParserOptions::getMaxIncludeSize ( )

Maximum size of template expansions, in bytes.

Returns: int

Definition at line 415 of file ParserOptions.php.

◆ getMaxPPExpandDepth()

ParserOptions::getMaxPPExpandDepth ( )

Maximum recursion depth in PPFrame::expand()

Returns: int

Definition at line 449 of file ParserOptions.php.

◆ getMaxPPNodeCount()

ParserOptions::getMaxPPNodeCount ( )

Maximum number of nodes touched by PPFrame::expand()

Returns: int

Definition at line 432 of file ParserOptions.php.

◆ getMaxTemplateDepth()

ParserOptions::getMaxTemplateDepth ( )

Maximum recursion depth for templates within templates.

Returns: int

Definition at line 457 of file ParserOptions.php.

◆ getNumberHeadings()

ParserOptions::getNumberHeadings ( )

Automatically number headings?

Returns: bool

Definition at line 335 of file ParserOptions.php.

◆ getOption()

ParserOptions::getOption ( $name )

Fetch an option and track that is was accessed.

Since: 1.30

Parameters

string $name Option name

Returns: mixed

Definition at line 146 of file ParserOptions.php.

References lazyLoadOption(), and optionUsed().

Referenced by initSpeculativePageId(), and initSpeculativeRevId().

◆ getPreSaveTransform()

ParserOptions::getPreSaveTransform ( )

Transform wiki markup when saving the page?

Returns: bool

Definition at line 688 of file ParserOptions.php.

Referenced by Parser\preSaveTransform().

◆ getRedirectTarget()

ParserOptions::getRedirectTarget ( )

Get the previously-set redirect target.

Since: 1.24

Returns: Title|null

Definition at line 1015 of file ParserOptions.php.

◆ getRemoveComments()

ParserOptions::getRemoveComments ( )

Remove HTML comments.

Warning: Only applies to preprocess operations

Returns: bool

Definition at line 494 of file ParserOptions.php.

◆ getSpeculativePageId()

ParserOptions::getSpeculativePageId ( )

A guess for {{PAGEID}}, calculated using the callback provided via setSpeculativeRevPageCallback().

For consistency, the value will be calculated upon the first call of this method, and re-used for subsequent calls.

If no callback was defined via setSpeculativePageIdCallback(), this method will return false.

Since: 1.34

Returns: int|false

Definition at line 923 of file ParserOptions.php.

◆ getSpeculativeRevId()

ParserOptions::getSpeculativeRevId ( )

A guess for {{REVISIONID}}, calculated using the callback provided via setSpeculativeRevIdCallback().

For consistency, the value will be calculated upon the first call of this method, and re-used for subsequent calls.

If no callback was defined via setSpeculativeRevIdCallback(), this method will return false.

Since: 1.32

Returns: int|false

Definition at line 909 of file ParserOptions.php.

◆ getStubThreshold()

ParserOptions::getStubThreshold ( )

Thumb size preferred by the user.

Deprecated:: since 1.37. Stub threshold feature has been removed. See T284917.

Returns: int

Definition at line 617 of file ParserOptions.php.

References wfDeprecated().

◆ getTargetLanguage()

ParserOptions::getTargetLanguage ( )

Target language for the parse.

Returns: Language|null

Definition at line 398 of file ParserOptions.php.

◆ getTemplateCallback()

ParserOptions::getTemplateCallback ( )

Callback for template fetching; first argument to call_user_func().

Returns: callable

Definition at line 886 of file ParserOptions.php.

◆ getThumbSize()

ParserOptions::getThumbSize ( )

Thumb size preferred by the user.

Returns: int

Definition at line 599 of file ParserOptions.php.

◆ getTimestamp()

ParserOptions::getTimestamp ( )

Timestamp used for {{CURRENTDAY}} etc.

Returns: string TS_MW timestamp

Definition at line 981 of file ParserOptions.php.

References wfTimestampNow().

◆ getUser()

ParserOptions::getUser ( )

Current user.

Deprecated:: since 1.36. Use ::getUserIdentity instead. Hard deprecated since 1.37.

Returns: User

Definition at line 1035 of file ParserOptions.php.

References wfDeprecated().

◆ getUserIdentity()

ParserOptions::getUserIdentity ( )

Get the identity of the user for whom the parse is made.

Since: 1.36

Returns: UserIdentity

Definition at line 1047 of file ParserOptions.php.

Referenced by Parser\fuzzTestPst(), and initDateFormat().

◆ getUserLang()

ParserOptions::getUserLang ( )

Same as getUserLangObj() but returns a string instead.

Warning: Calling this causes the parser cache to be fragmented by user language! To avoid cache fragmentation, output should not depend on the user language. Use Parser::getFunctionLang() or Parser::getTargetLanguage() instead!

See also: getUserLangObj()

Returns: string Language code

Since: 1.17

Definition at line 761 of file ParserOptions.php.

◆ getUserLangObj()

ParserOptions::getUserLangObj ( )

Get the user language used by the parser for this page and split the parser cache.

Warning: Calling this causes the parser cache to be fragmented by user language! To avoid cache fragmentation, output should not depend on the user language. Use Parser::getFunctionLang() or Parser::getTargetLanguage() instead!

Note: This function will trigger a cache fragmentation by recording the 'userlang' option, see optionUsed(). This is done to avoid cache pollution when the page is rendered based on the language of the user.; When saving, this will return the default language instead of the user's. {{int: }} uses this which used to produce inconsistent link tables (T16404).

Returns: Language

Since: 1.19

Definition at line 745 of file ParserOptions.php.

◆ getWrapOutputClass()

ParserOptions::getWrapOutputClass ( )

Class to use to wrap output from Parser::parse()

Since: 1.30

Returns: string|bool

Definition at line 840 of file ParserOptions.php.

◆ initDateFormat()

static ParserOptions::initDateFormat ( ParserOptions $popt )

staticprivate

Lazy initializer for dateFormat.

Parameters

ParserOptions $popt

Returns: string

Definition at line 714 of file ParserOptions.php.

References getUserIdentity().

◆ initialiseFromUser()

ParserOptions::initialiseFromUser	(	UserIdentity	$user,
		Language	$lang
	)

private

Get user options.

Parameters

UserIdentity	$user
Language	$lang

Definition at line 1268 of file ParserOptions.php.

References $lang.

◆ initSpeculativePageId()

static ParserOptions::initSpeculativePageId ( ParserOptions $popt )

staticprivate

Callback registered with ParserOptions::$lazyOptions, triggered by getSpeculativePageId().

Parameters

ParserOptions $popt

Returns: int|false

Definition at line 947 of file ParserOptions.php.

References getOption().

◆ initSpeculativeRevId()

static ParserOptions::initSpeculativeRevId ( ParserOptions $popt )

staticprivate

Callback registered with ParserOptions::$lazyOptions, triggered by getSpeculativeRevId().

Parameters

ParserOptions $popt

Returns: int|false

Definition at line 933 of file ParserOptions.php.

References getOption().

◆ isSafeToCache()

ParserOptions::isSafeToCache ( array $usedOptions = null )

Test whether these options are safe to cache.

Parameters

string[] | null $usedOptions the list of options actually used in the parse. Defaults to all options.

Returns: bool

Since: 1.30

Definition at line 1482 of file ParserOptions.php.

Referenced by MediaWiki\Parser\RevisionOutputCache\save().

◆ lazyLoadOption()

ParserOptions::lazyLoadOption ( $name )

private

Parameters

string $name Lazy load option without tracking usage

Definition at line 159 of file ParserOptions.php.

References $lazyOptions.

Referenced by getOption(), matches(), and matchesForCacheKey().

◆ matches()

ParserOptions::matches ( ParserOptions $other )

Check if these options match that of another options set.

This ignores report limit settings that only affect HTML comments

Parameters

ParserOptions $other

Returns: bool

Since: 1.25

Definition at line 1291 of file ParserOptions.php.

References lazyLoadOption().

◆ matchesForCacheKey()

ParserOptions::matchesForCacheKey ( ParserOptions $other )

Parameters

ParserOptions $other

Returns: bool Whether the cache key relevant options match those of $other

Since: 1.33

Definition at line 1336 of file ParserOptions.php.

References lazyLoadOption().

◆ newCanonical()

static ParserOptions::newCanonical	(	$context,
		$userLang = `null`
	)

static

Creates a "canonical" ParserOptions object.

For historical reasons, certain options have default values that are different from the canonical values used for caching.

Since: 1.30; 1.32 Added string and IContextSource as options for the first parameter; 1.36 UserIdentity is also allowed

Parameters

IContextSource \| string \| UserIdentity	$context	If an IContextSource, the options are initialized based on the source's UserIdentity and Language. If the string 'canonical', the options are initialized with an anonymous user and the content language. If a UserIdentity, the options are initialized for that UserIdentity 'userlang' is taken from the $userLang parameter, defaulting to $wgLang if that is null.
Language \| StubObject \| null	$userLang	(see above)

Returns: ParserOptions

Definition at line 1134 of file ParserOptions.php.

◆ newFromAnon()

static ParserOptions::newFromAnon ( )

static

Get a ParserOptions object for an anonymous user.

Warning: For interaction with the parser cache, use WikiPage::makeParserOptions() or ParserOptions::newCanonical() instead.

Since: 1.27

Returns: ParserOptions

Definition at line 1073 of file ParserOptions.php.

◆ newFromContext()

static ParserOptions::newFromContext ( IContextSource $context )

static

Get a ParserOptions object from a IContextSource object.

Warning: For interaction with the parser cache, use WikiPage::makeParserOptions() or ParserOptions::newCanonical() instead.

Parameters

IContextSource $context

Returns: ParserOptions

Definition at line 1112 of file ParserOptions.php.

References IContextSource\getLanguage(), and IContextSource\getUser().

◆ newFromUser()

static ParserOptions::newFromUser ( $user )

static

Get a ParserOptions object from a given user.

Language will be taken from $wgLang.

Warning: For interaction with the parser cache, use WikiPage::makeParserOptions() or ParserOptions::newCanonical() instead.

Parameters

UserIdentity $user

Returns: ParserOptions

Definition at line 1087 of file ParserOptions.php.

◆ newFromUserAndLang()

static ParserOptions::newFromUserAndLang	(	UserIdentity	$user,
		Language	$lang
	)

static

Get a ParserOptions object from a given user and language.

Warning: For interaction with the parser cache, use WikiPage::makeParserOptions() or ParserOptions::newCanonical() instead.

Parameters

UserIdentity	$user
Language	$lang

Returns: ParserOptions

Definition at line 1100 of file ParserOptions.php.

References $lang.

◆ nullifyLazyOption()

ParserOptions::nullifyLazyOption ( array $options )

private

Resets lazy loaded options to null in the provided $options array.

Parameters

array $options

Returns: array

Definition at line 171 of file ParserOptions.php.

References getLazyOptions().

◆ optionsHash()

ParserOptions::optionsHash	(	$forOptions,
		$title = `null`
	)

Generate a hash string with the values set on these ParserOptions for the keys given in the array.

This will be used as part of the hash key for the parser cache, so users sharing the options with vary for the same page share the same cached data safely.

Since: 1.17

Parameters

string[]	$forOptions
Title \| null	$title	Used to get the content language of the page (since r97636)

Returns: string Page rendering hash

Definition at line 1417 of file ParserOptions.php.

References $lang, $title, and $wgRenderHashAppend.

Referenced by WikitextContent\fillParserOutput().

◆ optionToString()

ParserOptions::optionToString ( $value )

private

Convert an option to a string value.

Parameters

mixed $value

Returns: string

Definition at line 1389 of file ParserOptions.php.

◆ optionUsed()

ParserOptions::optionUsed ( $optionName )

Called when an option is accessed.

Calls the watcher that was set using registerWatcher(). Typically, the watcher callback is ParserOutput::registerOption(). The information registered that way will be used by ParserCache::save().

Parameters

string $optionName Name of the option

Definition at line 1369 of file ParserOptions.php.

Referenced by getOption().

◆ registerWatcher()

ParserOptions::registerWatcher ( $callback )

Registers a callback for tracking which ParserOptions which are used.

This is a private API with the parser.

Parameters

callable | null $callback

Definition at line 1357 of file ParserOptions.php.

◆ setAllowExternalImages()

ParserOptions::setAllowExternalImages ( $x )

Allow all external images inline?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Deprecated:: since 1.35; per-parser configuration of image handling via parser options is deprecated. Use site configuration.

Definition at line 280 of file ParserOptions.php.

References wfDeprecated().

◆ setAllowExternalImagesFrom()

ParserOptions::setAllowExternalImagesFrom ( $x )

External images to allow.

When self::getAllowExternalImages() is false

Parameters

string | string[] | null $x New value (null is no change)

Returns: string|string[] Old value

Deprecated:: since 1.35; per-parser configuration of image handling via parser options is deprecated. Use site configuration.

Definition at line 306 of file ParserOptions.php.

References wfDeprecated().

◆ setAllowSpecialInclusion()

ParserOptions::setAllowSpecialInclusion ( $x )

Allow inclusion of special pages?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 361 of file ParserOptions.php.

◆ setAllowUnsafeRawHtml()

ParserOptions::setAllowUnsafeRawHtml ( $x )

If the wiki is configured to allow raw html ($wgRawHtml = true) is it allowed in the specific case of parsing this page.

See also: self::getAllowUnsafeRawHtml()

Since: 1.29

Parameters

bool | null $x Value to set or null to get current value

Returns: bool Current value for allowUnsafeRawHtml

Definition at line 831 of file ParserOptions.php.

◆ setCleanSignatures()

ParserOptions::setCleanSignatures ( $x )

Clean up signature texts?

See also: Parser::cleanSig

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 540 of file ParserOptions.php.

◆ setCurrentRevisionRecordCallback()

ParserOptions::setCurrentRevisionRecordCallback ( $x )

Callback for current revision fetching; first argument to call_user_func().

Access: internal

Since: 1.35

Parameters

callable | null $x New value

Returns: callable Old value

Definition at line 878 of file ParserOptions.php.

◆ setDateFormat()

ParserOptions::setDateFormat ( $x )

Date format index.

Parameters

string | null $x New value (null is no change)

Returns: string Old value

Definition at line 724 of file ParserOptions.php.

◆ setEnableImageWhitelist()

ParserOptions::setEnableImageWhitelist ( $x )

Use the on-wiki external image whitelist?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Deprecated:: since 1.35; per-parser configuration of image handling via parser options is deprecated. Use site configuration.

Definition at line 326 of file ParserOptions.php.

References wfDeprecated().

◆ setExpensiveParserFunctionLimit()

ParserOptions::setExpensiveParserFunctionLimit ( $x )

Maximum number of calls per parse to expensive parser functions.

Since: 1.20

Parameters

int | null $x New value (null is no change)

Returns: int Old value

Definition at line 485 of file ParserOptions.php.

◆ setExternalLinkTarget()

ParserOptions::setExternalLinkTarget ( $x )

Target attribute for external links.

Parameters

string | null $x New value (null is no change)

Returns: string Old value

Definition at line 557 of file ParserOptions.php.

◆ setInterfaceMessage()

ParserOptions::setInterfaceMessage ( $x )

Parsing an interface message?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 390 of file ParserOptions.php.

◆ setInterwikiMagic()

ParserOptions::setInterwikiMagic ( $x )

Specify whether to extract interlanguage links.

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 261 of file ParserOptions.php.

◆ setIsPreview()

ParserOptions::setIsPreview ( $x )

Parsing the page for a "preview" operation?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 646 of file ParserOptions.php.

Referenced by ApiParse\tweakParserOptions().

◆ setIsPrintable()

ParserOptions::setIsPrintable ( $x )

Parsing the printable version of the page?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 680 of file ParserOptions.php.

◆ setIsSectionPreview()

ParserOptions::setIsSectionPreview ( $x )

Parsing the page for a "preview" operation on a single section?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 663 of file ParserOptions.php.

Referenced by ApiParse\tweakParserOptions().

◆ setMaxIncludeSize()

ParserOptions::setMaxIncludeSize ( $x )

Maximum size of template expansions, in bytes.

Parameters

int | null $x New value (null is no change)

Returns: int Old value

Definition at line 424 of file ParserOptions.php.

◆ setMaxPPNodeCount()

ParserOptions::setMaxPPNodeCount ( $x )

Maximum number of nodes touched by PPFrame::expand()

Parameters

int | null $x New value (null is no change)

Returns: int Old value

Definition at line 441 of file ParserOptions.php.

◆ setMaxTemplateDepth()

ParserOptions::setMaxTemplateDepth ( $x )

Maximum recursion depth for templates within templates.

Parameters

int | null $x New value (null is no change)

Returns: int Old value

Definition at line 466 of file ParserOptions.php.

◆ setNumberHeadings()

ParserOptions::setNumberHeadings ( $x )

Automatically number headings?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 344 of file ParserOptions.php.

◆ setOption()

ParserOptions::setOption	(	$name,
		$value
	)

Set an option, generically.

Since: 1.30

Parameters

string	$name	Option name
mixed	$value	New value. Passing null will set null, unlike many of the existing accessors which ignore null for historical reasons.

Returns: mixed Old value

Definition at line 220 of file ParserOptions.php.

◆ setOptionLegacy()

ParserOptions::setOptionLegacy	(	$name,
		$value
	)

protected

Legacy implementation.

Since: 1.30 For implementing legacy setters only. Don't use this in new code.

Deprecated:: since 1.30

Parameters

string	$name	Option name
mixed	$value	New value. Passing null does not set the value.

Returns: mixed Old value

Definition at line 237 of file ParserOptions.php.

References wfSetVar().

◆ setPreSaveTransform()

ParserOptions::setPreSaveTransform ( $x )

Transform wiki markup when saving the page?

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 697 of file ParserOptions.php.

◆ setRedirectTarget()

ParserOptions::setRedirectTarget ( $title )

Note that setting or changing this does not make the page a redirect or change its target, it merely records the information for reference during the parse.

Since: 1.24

Parameters

Title | null $title

Definition at line 1005 of file ParserOptions.php.

References $title.

◆ setRemoveComments()

ParserOptions::setRemoveComments ( $x )

Remove HTML comments.

Warning: Only applies to preprocess operations

Parameters

bool | null $x New value (null is no change)

Returns: bool Old value

Definition at line 504 of file ParserOptions.php.

◆ setSpeculativePageIdCallback()

ParserOptions::setSpeculativePageIdCallback ( $x )

Callback to generate a guess for {{PAGEID}}.

Parameters

callable | null $x New value

Returns: callable|null Old value

Since: 1.34

Definition at line 972 of file ParserOptions.php.

◆ setSpeculativeRevIdCallback()

ParserOptions::setSpeculativeRevIdCallback ( $x )

Callback to generate a guess for {{REVISIONID}}.

Parameters

callable | null $x New value

Returns: callable|null Old value

Since: 1.28

Definition at line 961 of file ParserOptions.php.

◆ setStubThreshold()

ParserOptions::setStubThreshold ( $x )

Thumb size preferred by the user.

Deprecated:: since 1.37. Stub threshold feature has been removed. See T284917.

Parameters

int | null $x New value (null is no change)

Returns: int Old value

Definition at line 628 of file ParserOptions.php.

References wfDeprecated().

◆ setTargetLanguage()

ParserOptions::setTargetLanguage ( $x )

Target language for the parse.

Parameters

Language | null $x New value

Returns: Language|null Old value

Definition at line 407 of file ParserOptions.php.

◆ setTemplateCallback()

ParserOptions::setTemplateCallback ( $x )

Callback for template fetching; first argument to call_user_func().

Parameters

callable | null $x New value (null is no change)

Returns: callable Old value

Definition at line 895 of file ParserOptions.php.

◆ setThumbSize()

ParserOptions::setThumbSize ( $x )

Thumb size preferred by the user.

Parameters

int | null $x New value (null is no change)

Returns: int Old value

Definition at line 608 of file ParserOptions.php.

◆ setTidy()

ParserOptions::setTidy ( $x )

Use tidy to cleanup output HTML?

Parameters

bool | null $x New value (null is no change)

Returns: null

Deprecated:: since 1.35; tidy is always enabled so this has no effect

Definition at line 371 of file ParserOptions.php.

References wfDeprecated().

◆ setTimestamp()

ParserOptions::setTimestamp ( $x )

Timestamp used for {{CURRENTDAY}} etc.

Parameters

string | null $x New value (null is no change)

Returns: string Old value

Definition at line 993 of file ParserOptions.php.

References wfSetVar().

◆ setupFakeRevision()

ParserOptions::setupFakeRevision	(	$title,
		$content,
		$user
	)

Sets a hook to force that a page exists, and sets a current revision callback to return a revision with custom content when the current revision of the page is requested.

Since: 1.25

Parameters

Title	$title
Content	$content
UserIdentity	$user	The user that the fake revision is attributed to

Returns: ScopedCallback to unset the hook

Definition at line 1508 of file ParserOptions.php.

References $content, $title, and $wgHooks.

◆ setUserLang()

ParserOptions::setUserLang ( $x )

Set the user language used by the parser for this page and split the parser cache.

Parameters

string | Language $x New value

Returns: Language Old value

Definition at line 770 of file ParserOptions.php.

◆ setWrapOutputClass()

ParserOptions::setWrapOutputClass ( $className )

CSS class to use to wrap output from Parser::parse()

Since: 1.30

Parameters

string $className Class name to use for wrapping. Passing false to indicate "no wrapping" was deprecated in MediaWiki 1.31.

Returns: string|bool Current value

Definition at line 851 of file ParserOptions.php.

References wfDeprecated().

Referenced by ApiParse\tweakParserOptions().

Member Data Documentation

◆ $cacheVaryingOptionsHash

array null ParserOptions::$cacheVaryingOptionsHash = null

staticprivate

Specify options that are included in the cache key.

Definition at line 74 of file ParserOptions.php.

◆ $callbacks

array ParserOptions::$callbacks

staticprivate

Initial value:

= [
        'currentRevisionRecordCallback' => true,
        'templateCallback' => true,
        'speculativeRevIdCallback' => true,
        'speculativePageIdCallback' => true,
    ]

Specify pseudo-options that are actually callbacks.

These must be ignored when checking for cacheability.

Definition at line 93 of file ParserOptions.php.

◆ $defaults

array null ParserOptions::$defaults = null

staticprivate

Default values for all options that are relevant for caching.

See also: self::getDefaults()

Definition at line 52 of file ParserOptions.php.

◆ $initialCacheVaryingOptionsHash

array ParserOptions::$initialCacheVaryingOptionsHash

staticprivate

Initial value:

= [
        'dateformat' => true,
        'numberheadings' => true,
        'thumbsize' => true,
        'printable' => true,
        'userlang' => true,
    ]

Initial inCacheKey options (before hook)

Definition at line 80 of file ParserOptions.php.

◆ $initialLazyOptions

callable [] ParserOptions::$initialLazyOptions

staticprivate

Initial value:

= [
        'dateformat' => [ __CLASS__, 'initDateFormat' ],
        'speculativeRevId' => [ __CLASS__, 'initSpeculativeRevId' ],
        'speculativePageId' => [ __CLASS__, 'initSpeculativePageId' ],
    ]

Initial lazy-loaded options (before hook)

Definition at line 64 of file ParserOptions.php.

◆ $lazyOptions

callable [] null ParserOptions::$lazyOptions = null

staticprivate

Lazy-loaded options.

Definition at line 58 of file ParserOptions.php.

Referenced by lazyLoadOption().

◆ $mExtraKey

ParserOptions::$mExtraKey = ''

private

Appended to the options hash.

Definition at line 138 of file ParserOptions.php.

◆ $mTimestamp

string null ParserOptions::$mTimestamp

private

Timestamp used for {{CURRENTDAY}} etc.

Note: Caching based on parse time is handled externally

Definition at line 111 of file ParserOptions.php.

◆ $mUser

UserIdentity ParserOptions::$mUser

private

Stored user object.

Todo:: Track this for caching somehow without fragmenting the cache insanely

Definition at line 118 of file ParserOptions.php.

◆ $onAccessCallback

callable null ParserOptions::$onAccessCallback = null

private

Function to be called when an option is accessed.

Note: Used for collecting used options, does not affect caching

Definition at line 125 of file ParserOptions.php.

◆ $options

array ParserOptions::$options

private

Current values for all options that are relevant for caching.

Definition at line 104 of file ParserOptions.php.

◆ $redirectTarget

Title null ParserOptions::$redirectTarget = null

private

If the page being parsed is a redirect, this should hold the redirect target.

Todo:: Track this for caching somehow

Definition at line 133 of file ParserOptions.php.

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

includes/parser/ParserOptions.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addExtraKey()

◆ allCacheVaryingOptions()

◆ clearStaticCache()

◆ disableContentConversion()

◆ disableTitleConversion()

◆ enableLimitReport()

◆ getAllowExternalImages()

◆ getAllowExternalImagesFrom()

◆ getAllowSpecialInclusion()

◆ getAllowUnsafeRawHtml()

◆ getCacheVaryingOptionsHash()

◆ getCanonicalOverrides()

◆ getCleanSignatures()

◆ getCurrentRevisionRecordCallback()

◆ getDateFormat()

◆ getDefaults()

◆ getDisableContentConversion()

◆ getDisableTitleConversion()

◆ getEnableImageWhitelist()

◆ getEnableLimitReport()

◆ getExpensiveParserFunctionLimit()

◆ getExternalLinkTarget()

◆ getInterfaceMessage()

◆ getInterwikiMagic()

◆ getIsPreview()

◆ getIsPrintable()

◆ getIsSectionPreview()

◆ getLazyOptions()

◆ getMagicISBNLinks()

◆ getMagicPMIDLinks()

◆ getMagicRFCLinks()

◆ getMaxIncludeSize()

◆ getMaxPPExpandDepth()

◆ getMaxPPNodeCount()

◆ getMaxTemplateDepth()

◆ getNumberHeadings()

◆ getOption()

◆ getPreSaveTransform()

◆ getRedirectTarget()

◆ getRemoveComments()

◆ getSpeculativePageId()

◆ getSpeculativeRevId()

◆ getStubThreshold()

◆ getTargetLanguage()

◆ getTemplateCallback()

◆ getThumbSize()

◆ getTimestamp()

◆ getUser()

◆ getUserIdentity()

◆ getUserLang()

◆ getUserLangObj()

◆ getWrapOutputClass()

◆ initDateFormat()

◆ initialiseFromUser()

◆ initSpeculativePageId()

◆ initSpeculativeRevId()

◆ isSafeToCache()

◆ lazyLoadOption()

◆ matches()

◆ matchesForCacheKey()

◆ newCanonical()

◆ newFromAnon()

◆ newFromContext()

◆ newFromUser()

◆ newFromUserAndLang()

◆ nullifyLazyOption()

◆ optionsHash()

◆ optionToString()

◆ optionUsed()