View source for Manual:$wgParser

<languages/>
{{GlobalClassVar
|name = Parser
|summary = <translate><!--T:7--> Parser object</translate>
|class = Parser
|source = {{ll|Manual:Parser.php|Parser.php}}
|deprecated=1.32.0
|removed=1.39.0
}}
<translate>
==Description== <!--T:1-->
</translate>

<translate><!--T:2--> The Parser object is responsible for parsing the tags and wikitext contained in wiki pages.</translate>
<translate><!--T:14--> Parser extensions hooks are also registered in the Parser object.</translate>

{{Info
|1=<translate><!--T:13--> Use <tvar name=1>{{phpi|MediaWikiServices::getInstance()->getParser()}}</tvar> instead (<tvar name=2>[[phab:T160811]]</tvar>).</translate>
|2=warn
}}

<translate>
==Mode of Operation== <!--T:3-->

<!--T:4-->
<tvar name=1>{{phpi|$wgParser}}</tvar> is called in <tvar name=2><code>includes/Setup.php</code></tvar> with the following code:
</translate>

<syntaxhighlight lang="php" style="overflow:auto;">
$wgParser = new StubObject( 'wgParser', $wgParserConf['class'], array( $wgParserConf ) );
</syntaxhighlight>

<translate>
<!--T:5-->
StubObject is defined in <code>includes/StubObject.php</code>.

<!--T:6-->
wgParserConf is defined in <code>includes/DefaultSettings.php</code> with the following code:
</translate>

<syntaxhighlight lang="php" style="overflow:auto;">
$wgParserConf = array('class' => 'Parser',);
</syntaxhighlight>

<translate>
== Replacement == <!--T:8-->
</translate>
{{MW 1.32|+}}
<translate><!--T:9--> New code should use [[<tvar name=1>Special:MyLanguage/Dependency Injection</tvar>|dependency injection]] instead.</translate>
<translate><!--T:10--> The parser is now available in the service locator under the <tvar name=1><code>Parser</code></tvar> service.</translate>
<translate><!--T:11--> Existing code that has not yet been changed to use dependency injection can call the service locator directly:</translate>

<syntaxhighlight lang="php">
public function render() {
    $parser = \MediaWiki\MediaWikiServices::getInstance()->getParser();
    $text = $parser->parse(
        ...
    )->getText();
}
</syntaxhighlight>