RenderedRevision represents the rendered representation of a revision. More...

Inheritance diagram for Revision\RenderedRevision:

Collaboration diagram for Revision\RenderedRevision:

[legend]

Public Member Functions
	__construct (Title $title, RevisionRecord $revision, ParserOptions $options, callable $combineOutput, $audience=RevisionRecord::FOR_PUBLIC, User $forUser=null)

	getOptions ()

	getRevision ()

	getRevisionParserOutput (array $hints=[])

	getSlotParserOutput ( $role, array $hints=[])

	isContentDeleted ()

	setSaveParseLogger (LoggerInterface $saveParseLogger)

	updateRevision (RevisionRecord $rev)
	Updates the RevisionRecord after the revision has been saved. More...

Private Member Functions
	getSlotParserOutputUncached (Content $content, $withHtml)

	outputVariesOnRevisionMetaData (ParserOutput $out, $actualRevId)

	pruneRevisionSensitiveOutput ( $actualRevId)
	Prune any output that depends on the revision ID. More...

	setRevisionInternal (RevisionRecord $revision)

Private Attributes
int	$audience = RevisionRecord::FOR_PUBLIC
	Audience to check when accessing content. More...

callable	$combineOutput
	Callback for combining slot output into revision output. More...

User null	$forUser = null
	The user to use for audience checks during content access. More...

ParserOptions	$options

RevisionRecord	$revision

ParserOutput null	$revisionOutput = null
	The combined ParserOutput for the revision, initialized lazily by getRevisionParserOutput(). More...

LoggerInterface	$saveParseLogger
	For profiling ParserOutput re-use. More...

ParserOutput[]	$slotsOutput = []
	The ParserOutput for each slot, initialized lazily by getSlotParserOutput(). More...

Title	$title

Detailed Description

RenderedRevision represents the rendered representation of a revision.

It acts as a lazy provider of ParserOutput objects for the revision's individual slots, as well as a combined ParserOutput of all slots.

Since: 1.32

Definition at line 44 of file RenderedRevision.php.

Constructor & Destructor Documentation

◆ __construct()

Revision\RenderedRevision::__construct	(	Title	$title,
		RevisionRecord	$revision,
		ParserOptions	$options,
		callable	$combineOutput,
			$audience = `RevisionRecord::FOR_PUBLIC`,
		User	$forUser = `null`
	)

Note: Application logic should not instantiate RenderedRevision instances directly, but should use a RevisionRenderer instead.

Parameters

Title	$title
RevisionRecord	$revision	The revision to render. The content for rendering will be taken from this RevisionRecord. However, if the RevisionRecord is not complete according isReadyForInsertion(), but a revision ID is known, the parser may load the revision from the database if it needs revision meta data to handle magic words like {{REVISIONUSER}}.
ParserOptions	$options
callable	$combineOutput	Callback for combining slot output into revision output. Signature: function ( RenderedRevision $this ): ParserOutput.
int	$audience	Use RevisionRecord::FOR_PUBLIC, FOR_THIS_USER, or RAW.
User \| null	$forUser	Required if $audience is FOR_THIS_USER.

Definition at line 108 of file RenderedRevision.php.

References Revision\RenderedRevision\$audience, Revision\RenderedRevision\$combineOutput, Revision\RenderedRevision\$forUser, Revision\RenderedRevision\$options, Revision\RenderedRevision\$title, Revision\RevisionRecord\FOR_THIS_USER, options(), Revision\RenderedRevision\setRevisionInternal(), and title.

Member Function Documentation

◆ getOptions()

Revision\RenderedRevision::getOptions ( )

Returns: ParserOptions

Definition at line 158 of file RenderedRevision.php.

References Revision\RenderedRevision\$options.

Referenced by Revision\RevisionRenderer\combineSlotOutput().

◆ getRevision()

Revision\RenderedRevision::getRevision ( )

Returns: RevisionRecord

Definition at line 151 of file RenderedRevision.php.

References Revision\RenderedRevision\$revision.

Referenced by MediaWiki\Tests\Revision\RenderedRevisionTest\combineOutput(), and Revision\RevisionRenderer\combineSlotOutput().

◆ getRevisionParserOutput()

Revision\RenderedRevision::getRevisionParserOutput ( array $hints = [] )

Parameters

array

$hints

Hints given as an associative array. Known keys:

'generate-html' => bool: Whether the caller is interested in output HTML (as opposed to just meta-data). Default is to generate HTML.

Returns: ParserOutput

Definition at line 169 of file RenderedRevision.php.

References $output, and Revision\RenderedRevision\$revisionOutput.

◆ getSlotParserOutput()

Revision\RenderedRevision::getSlotParserOutput	(		$role,
		array	$hints = `[]`
	)

Parameters

string	$role
array	$hints	Hints given as an associative array. Known keys: 'generate-html' => bool: Whether the caller is interested in output HTML (as opposed to just meta-data). Default is to generate HTML.

Exceptions

SuppressedDataException if the content is not accessible for the audience specified in the constructor.

Returns: ParserOutput

Implements Revision\SlotRenderingProvider.

Definition at line 198 of file RenderedRevision.php.

References $content, $output, Revision\RenderedRevision\getSlotParserOutputUncached(), options(), and revision.

Referenced by MediaWiki\Tests\Revision\RenderedRevisionTest\combineOutput(), and Revision\RevisionRenderer\combineSlotOutput().

◆ getSlotParserOutputUncached()

Revision\RenderedRevision::getSlotParserOutputUncached	(	Content	$content,
			$withHtml
	)

private

Note: This method exist to make duplicate parses easier to see during profiling

Parameters

Content	$content
bool	$withHtml

Returns: ParserOutput

Definition at line 237 of file RenderedRevision.php.

References $content, Revision\RenderedRevision\$options, revision, and title.

Referenced by Revision\RenderedRevision\getSlotParserOutput().

◆ isContentDeleted()

Revision\RenderedRevision::isContentDeleted ( )

Returns: bool Whether the revision's content has been hidden from unprivileged users.

Definition at line 144 of file RenderedRevision.php.

References Revision\RevisionRecord\DELETED_TEXT, and revision.

◆ outputVariesOnRevisionMetaData()

Revision\RenderedRevision::outputVariesOnRevisionMetaData	(	ParserOutput	$out,
			$actualRevId
	)

private

Parameters

ParserOutput	$out
int \| bool	$actualRevId	The actual rev id, to check the used speculative rev ID against, or false to not purge on vary-revision-id, or true to purge on vary-revision-id unconditionally.

Returns: bool

Definition at line 356 of file RenderedRevision.php.

References $out, and wfDebug().

Referenced by Revision\RenderedRevision\pruneRevisionSensitiveOutput().

◆ pruneRevisionSensitiveOutput()

Revision\RenderedRevision::pruneRevisionSensitiveOutput ( $actualRevId )

private

Prune any output that depends on the revision ID.

Parameters

int | bool $actualRevId The actual rev id, to check the used speculative rev ID against, or false to not purge on vary-revision-id, or true to purge on vary-revision-id unconditionally.

Definition at line 281 of file RenderedRevision.php.

References $output, as, and Revision\RenderedRevision\outputVariesOnRevisionMetaData().

Referenced by Revision\RenderedRevision\updateRevision().

◆ setRevisionInternal()

Revision\RenderedRevision::setRevisionInternal ( RevisionRecord $revision )

private

Parameters

RevisionRecord $revision

Definition at line 300 of file RenderedRevision.php.

References $parser, Revision\RenderedRevision\$revision, Revision\RenderedRevision\$title, Title\equals(), options(), revision, and use.

Referenced by Revision\RenderedRevision\__construct(), and Revision\RenderedRevision\updateRevision().

◆ setSaveParseLogger()

Revision\RenderedRevision::setSaveParseLogger ( LoggerInterface $saveParseLogger )

Parameters

LoggerInterface $saveParseLogger

Definition at line 137 of file RenderedRevision.php.

References Revision\RenderedRevision\$saveParseLogger.

Referenced by Revision\RevisionRenderer\getRenderedRevision().

◆ updateRevision()

Revision\RenderedRevision::updateRevision ( RevisionRecord $rev )

Updates the RevisionRecord after the revision has been saved.

This can be used to discard and cached ParserOutput so parser functions like {{REVISIONTIMESTAMP}} or {{REVISIONID}} are re-evaluated.

Note: There should be no need to call this for null-edits.

Parameters

RevisionRecord $rev

Definition at line 255 of file RenderedRevision.php.

References $rev, Revision\RevisionRecord\getId(), Revision\RevisionRecord\getSlots(), Revision\RenderedRevision\pruneRevisionSensitiveOutput(), revision, and Revision\RenderedRevision\setRevisionInternal().

Member Data Documentation

◆ $audience

int Revision\RenderedRevision::$audience = RevisionRecord::FOR_PUBLIC

private

Audience to check when accessing content.

Definition at line 62 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\__construct().

◆ $combineOutput

callable Revision\RenderedRevision::$combineOutput

private

Callback for combining slot output into revision output.

Signature: function ( RenderedRevision $this ): ParserOutput.

Definition at line 85 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\__construct().

◆ $forUser

User null Revision\RenderedRevision::$forUser = null

private

The user to use for audience checks during content access.

Definition at line 67 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\__construct().

◆ $options

ParserOptions Revision\RenderedRevision::$options

private

Definition at line 57 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\__construct(), Revision\RenderedRevision\getOptions(), and Revision\RenderedRevision\getSlotParserOutputUncached().

◆ $revision

RevisionRecord Revision\RenderedRevision::$revision

private

Definition at line 52 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\getRevision(), and Revision\RenderedRevision\setRevisionInternal().

◆ $revisionOutput

ParserOutput null Revision\RenderedRevision::$revisionOutput = null

private

The combined ParserOutput for the revision, initialized lazily by getRevisionParserOutput().

Definition at line 73 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\getRevisionParserOutput().

◆ $saveParseLogger

LoggerInterface Revision\RenderedRevision::$saveParseLogger

private

For profiling ParserOutput re-use.

Definition at line 90 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\setSaveParseLogger().

◆ $slotsOutput

ParserOutput [] Revision\RenderedRevision::$slotsOutput = []

private

The ParserOutput for each slot, initialized lazily by getSlotParserOutput().

Definition at line 79 of file RenderedRevision.php.

◆ $title

Title Revision\RenderedRevision::$title

private

Definition at line 49 of file RenderedRevision.php.

Referenced by Revision\RenderedRevision\__construct(), and Revision\RenderedRevision\setRevisionInternal().

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

includes/Revision/RenderedRevision.php

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getOptions()

◆ getRevision()

◆ getRevisionParserOutput()

◆ getSlotParserOutput()

◆ getSlotParserOutputUncached()

◆ isContentDeleted()

◆ outputVariesOnRevisionMetaData()

◆ pruneRevisionSensitiveOutput()

◆ setRevisionInternal()

◆ setSaveParseLogger()

◆ updateRevision()

Member Data Documentation

◆ $audience

◆ $combineOutput

◆ $forUser

◆ $options

◆ $revision

◆ $revisionOutput

◆ $saveParseLogger

◆ $slotsOutput

◆ $title