MediaWiki  master
Revision\RevisionRenderer Class Reference

The RevisionRenderer service provides access to rendered output for revisions. More...

Collaboration diagram for Revision\RevisionRenderer:

Public Member Functions

 __construct (ILoadBalancer $loadBalancer, SlotRoleRegistry $roleRegistry, $wikiId=false)
 getRenderedRevision (RevisionRecord $rev, ParserOptions $options=null, User $forUser=null, array $hints=[])
 setLogger (LoggerInterface $saveParseLogger)

Private Member Functions

 combineSlotOutput (RenderedRevision $rrev, array $hints=[])
 This implements the layout for combining the output of multiple slots. More...
 getSpeculativeRevId ( $dbIndex)

Private Attributes

ILoadBalancer $loadBalancer
SlotRoleRegistry $roleRegistery
LoggerInterface $saveParseLogger
string bool $wikiId

Detailed Description

The RevisionRenderer service provides access to rendered output for revisions.

It does so be acting as a factory for RenderedRevision instances, which in turn provide lazy access to ParserOutput objects.

One key responsibility of RevisionRenderer is implementing the layout used to combine the output of multiple slots.


Definition at line 45 of file RevisionRenderer.php.

Constructor & Destructor Documentation

◆ __construct()

Revision\RevisionRenderer::__construct ( ILoadBalancer  $loadBalancer,
SlotRoleRegistry  $roleRegistry,
  $wikiId = false 
bool | string$wikiId

Definition at line 64 of file RevisionRenderer.php.

References Revision\RevisionRenderer\$loadBalancer, and Revision\RevisionRenderer\$wikiId.

Member Function Documentation

◆ combineSlotOutput()

Revision\RevisionRenderer::combineSlotOutput ( RenderedRevision  $rrev,
array  $hints = [] 

This implements the layout for combining the output of multiple slots.

Use placement hints from SlotRoleHandlers instead of hard-coding the layout.
array$hintssee RenderedRevision::getRevisionParserOutput()

Definition at line 185 of file RevisionRenderer.php.

References $html, $options, $out, as, Html\element(), Revision\RenderedRevision\getOptions(), Revision\RenderedRevision\getRevision(), Revision\RenderedRevision\getSlotParserOutput(), Revision\SlotRecord\MAIN, null, and Html\rawElement().

Referenced by Revision\RevisionRenderer\getRenderedRevision().

◆ getRenderedRevision()

Revision\RevisionRenderer::getRenderedRevision ( RevisionRecord  $rev,
ParserOptions  $options = null,
User  $forUser = null,
array  $hints = [] 
ParserOptions | null$options
User | null$forUserUser for privileged access. Default is unprivileged (public) access, unless the 'audience' hint is set to something else RevisionRecord::RAW.
array$hintsHints given as an associative array. Known keys:
  • 'use-master' Use master when rendering for the parser cache during save. Default is to use a replica.
  • 'audience' the audience to use for content access. Default is RevisionRecord::FOR_PUBLIC if $forUser is not set, RevisionRecord::FOR_THIS_USER if $forUser is set. Can be set to RevisionRecord::RAW to disable audience checks.
  • 'known-revision-output' a combined ParserOutput for the revision, perhaps from some cache. the caller is responsible for ensuring that the ParserOutput indeed matched the $rev and $options. This mechanism is intended as a temporary stop-gap, for the time until caches have been changed to store RenderedRevision states instead of ParserOutput objects.
RenderedRevision|null The rendered revision, or null if the audience checks fails.

Definition at line 102 of file RevisionRenderer.php.

References $options, $title, Revision\RevisionRenderer\$wikiId, array(), Revision\RevisionRecord\audienceCan(), Revision\RevisionRenderer\combineSlotOutput(), DB_MASTER, DB_REPLICA, Revision\RevisionRecord\DELETED_TEXT, Revision\RevisionRecord\FOR_PUBLIC, Revision\RevisionRecord\FOR_THIS_USER, Revision\RevisionRecord\getPageAsLinkTarget(), Revision\RevisionRenderer\getSpeculativeRevId(), Revision\RevisionRecord\getWikiId(), ParserOptions\newCanonical(), Title\newFromLinkTarget(), null, Revision\RenderedRevision\setSaveParseLogger(), and use.

◆ getSpeculativeRevId()

Revision\RevisionRenderer::getSpeculativeRevId (   $dbIndex)

Definition at line 157 of file RevisionRenderer.php.

References DB_REPLICA.

Referenced by Revision\RevisionRenderer\getRenderedRevision().

◆ setLogger()

Revision\RevisionRenderer::setLogger ( LoggerInterface  $saveParseLogger)

Definition at line 79 of file RevisionRenderer.php.

References Revision\RevisionRenderer\$saveParseLogger.

Member Data Documentation

◆ $loadBalancer

ILoadBalancer Revision\RevisionRenderer::$loadBalancer

Definition at line 51 of file RevisionRenderer.php.

Referenced by Revision\RevisionRenderer\__construct().

◆ $roleRegistery

SlotRoleRegistry Revision\RevisionRenderer::$roleRegistery

Definition at line 54 of file RevisionRenderer.php.

◆ $saveParseLogger

LoggerInterface Revision\RevisionRenderer::$saveParseLogger

Definition at line 48 of file RevisionRenderer.php.

Referenced by Revision\RevisionRenderer\setLogger().

◆ $wikiId

string bool Revision\RevisionRenderer::$wikiId

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