Inheritance diagram for Revision:

Collaboration diagram for Revision:

[legend]

Public Member Functions
	__construct ( $row, $queryFlags=0, Title $title=null)

	getComment ( $audience=self::FOR_PUBLIC, User $user=null)

	getContent ( $audience=self::FOR_PUBLIC, User $user=null)
	Fetch revision content if it's available to the specified audience.

	getContentFormat ()
	Returns the content format for the main slot of this revision.

	getContentHandler ()
	Returns the content handler appropriate for this revision's content model.

	getContentModel ()
	Returns the content model for the main slot of this revision.

	getId ()
	Get revision ID.

	getNext ()
	Get next revision for this title.

	getPage ()
	Get the page ID.

	getParentId ()
	Get parent revision ID (the original previous page revision)

	getPrevious ()
	Get previous revision for this title.

	getRecentChange ( $flags=0)
	Get the RC object belonging to the current revision, if there's one.

	getRevisionRecord ()

	getSerializedData ()
	Get original serialized data (without checking view restrictions)

	getSha1 ()
	Returns the base36 sha1 of the content in this revision, or null if unknown.

	getSize ()
	Returns the length of the text in this revision, or null if unknown.

	getTextId ()
	Get the ID of the row of the text table that contains the content of the revision's main slot, if that content is stored in the text table.

	getTimestamp ()

	getTitle ()
	Returns the title of the page associated with this entry.

	getUser ( $audience=self::FOR_PUBLIC, User $user=null)
	Fetch revision's user id if it's available to the specified audience.

	getUserText ( $audience=self::FOR_PUBLIC, User $user=null)
	Fetch revision's username if it's available to the specified audience.

	getVisibility ()
	Get the deletion bitfield of the revision.

	insertOn ( $dbw)
	Insert a new revision into the database, returning the new revision ID number on success and dies horribly on failure.

	isCurrent ()

	isDeleted ( $field)

	isMinor ()

	isUnpatrolled ()

	setId ( $id)
	Set the revision ID.

	setTitle ( $title)
	Set the title of the revision.

	setUserIdAndName ( $id, $name)
	Set the user ID/name.

	userCan ( $field, User $user=null)
	Determine if the current user is allowed to view a particular field of this revision, if it's marked as deleted.

Static Public Member Functions
static	base36Sha1 ( $text)
	Get the base 36 SHA-1 value for a string of text.

static	compressRevisionText (&$text)
	If $wgCompressRevisions is enabled, we will compress data.

static	countByPageId ( $db, $id)
	Get count of revisions per page...not very efficient.

static	countByTitle ( $db, $title)
	Get count of revisions per page...not very efficient.

static	decompressRevisionText ( $text, $flags)
	Re-converts revision text according to it's flags.

static	getArchiveQueryInfo ()
	Return the tables, fields, and join conditions to be selected to create a new archived revision object.

static	getParentLengths ( $db, array $revIds)
	Do a batched query to get the parent revision lengths.

static	getQueryInfo ( $options=[])
	Return the tables, fields, and join conditions to be selected to create a new revision object.

static	getRevisionText ( $row, $prefix='old_', $wiki=false)
	Get revision text associated with an old or archive row.

static	getTimestampFromId ( $title, $id, $flags=0)
	Get rev_timestamp from rev_id, without loading the rest of the row.

static	loadFromId ( $db, $id)
	Load a page revision from a given revision ID number.

static	loadFromPageId ( $db, $pageid, $id=0)
	Load either the current, or a specified, revision that's attached to a given page.

static	loadFromTimestamp ( $db, $title, $timestamp)
	Load the revision for the given title with the given timestamp.

static	loadFromTitle ( $db, $title, $id=0)
	Load either the current, or a specified, revision that's attached to a given page.

static	newFromArchiveRow ( $row, $overrides=[])
	Make a fake revision object from an archive table row.

static	newFromId ( $id, $flags=0)
	Load a page revision from a given revision ID number.

static	newFromPageId ( $pageId, $revId=0, $flags=0)
	Load either the current, or a specified, revision that's attached to a given page ID.

static	newFromRow ( $row)

static	newFromTitle (LinkTarget $linkTarget, $id=0, $flags=0)
	Load either the current, or a specified, revision that's attached to a given link target.

static	newKnownCurrent (IDatabase $db, $pageIdOrTitle, $revId=0)
	Load a revision based on a known page ID and current revision ID from the DB.

static	newNullRevision ( $dbw, $pageId, $summary, $minor, $user=null)
	Create a new null-revision for insertion into a page's history.

static	pageJoinCond ()
	Return the value of a select() page conds array for the page table.

static	selectArchiveFields ()
	Return the list of revision fields that should be selected to create a new revision from an archive row.

static	selectFields ()
	Return the list of revision fields that should be selected to create a new revision.

static	selectPageFields ()
	Return the list of page fields that should be selected from page table.

static	selectTextFields ()
	Return the list of text fields that should be selected to read the revision text.

static	selectUserFields ()
	Return the list of user fields that should be selected from user table.

static	userCanBitfield ( $bitfield, $field, User $user=null, Title $title=null)
	Determine if the current user is allowed to view a particular field of this revision, if it's marked as deleted.

static	userJoinCond ()
	Return the value of a select() JOIN conds array for the user table.

static	userWasLastToEdit ( $db, $pageId, $userId, $since)
	Check if no edits were made by other users since the time a user started editing the page.

Public Attributes
const	DELETED_COMMENT = RevisionRecord::DELETED_COMMENT

const	DELETED_RESTRICTED = RevisionRecord::DELETED_RESTRICTED

const	DELETED_TEXT = RevisionRecord::DELETED_TEXT

const	DELETED_USER = RevisionRecord::DELETED_USER

const	FOR_PUBLIC = RevisionRecord::FOR_PUBLIC

const	FOR_THIS_USER = RevisionRecord::FOR_THIS_USER

const	RAW = RevisionRecord::RAW

const	SUPPRESSED_ALL = RevisionRecord::SUPPRESSED_ALL

const	SUPPRESSED_USER = RevisionRecord::SUPPRESSED_USER

const	TEXT_CACHE_GROUP = SqlBlobStore::TEXT_CACHE_GROUP

Public Attributes inherited from IDBAccessObject
const	READ_LOCKING = self::READ_LATEST \| 2
	Constants for object loading bitfield flags (higher => higher QoS)

const	READ_NONE = -1

Static Protected Member Functions
static	getBlobStore ( $wiki=false)

static	getRevisionFactory ()

static	getRevisionLookup ()

static	getRevisionStore ( $wiki=false)

Protected Attributes
RevisionRecord	$mRecord

Private Member Functions
	ensureTitle ( $row, $queryFlags, $title=null)
	Make sure we have some Title object for use by the constructor.

	getMainSlotRaw ()

Detailed Description

Deprecated: since 1.31, use RevisionRecord, RevisionStore, and BlobStore instead.

Definition at line 40 of file Revision.php.

Constructor & Destructor Documentation

◆ __construct()

Revision::__construct	(		$row,
			$queryFlags = 0,
		Title	$title = null )

Parameters

object \| array \| RevisionRecord	$row	Either a database row or an array
int	$queryFlags
Title \| null	$title

Access:\n private

Definition at line 549 of file Revision.php.

References and(), ensureTitle(), and getRevisionFactory().

Member Function Documentation

◆ base36Sha1()

static Revision::base36Sha1 ( $text )

static

Get the base 36 SHA-1 value for a string of text.

Parameters

string $text

Returns: string

Definition at line 1179 of file Revision.php.

Referenced by RevisionDbTestBase\provideGetSha1(), PopulateRevisionSha1\upgradeLegacyArchiveRow(), and PopulateRevisionSha1\upgradeRow().

◆ compressRevisionText()

static Revision::compressRevisionText ( & $text )

static

If $wgCompressRevisions is enabled, we will compress data.

The input string is modified in place. Return value is the flags field: contains 'gzip' if the data is compressed, and 'utf-8' if we're saving in UTF-8 mode.

Parameters

mixed &$text Reference to a text

Returns: string

Definition at line 1124 of file Revision.php.

References getBlobStore().

Referenced by MigrateArchiveText\doDBUpdates(), CheckStorage\importRevision(), RevisionTest\testCompressRevisionTextUtf8(), and RevisionTest\testCompressRevisionTextUtf8Gzip().

◆ countByPageId()

static Revision::countByPageId	(		$db,
			$id )

static

Get count of revisions per page...not very efficient.

Parameters

IDatabase	$db
int	$id	Page id

Returns: int

Definition at line 1275 of file Revision.php.

References getRevisionStore().

◆ countByTitle()

static Revision::countByTitle	(		$db,
			$title )

static

Get count of revisions per page...not very efficient.

Parameters

IDatabase	$db
Title	$title

Returns: int

Definition at line 1286 of file Revision.php.

References getRevisionStore().

◆ decompressRevisionText()

static Revision::decompressRevisionText	(		$text,
			$flags )

static

Re-converts revision text according to it's flags.

Parameters

mixed	$text	Reference to a text
array	$flags	Compression flags

Returns: string|bool Decompressed text, or false on failure

Definition at line 1135 of file Revision.php.

References getBlobStore().

Referenced by RevisionTest\testDecompressRevisionText().

◆ ensureTitle()

Revision::ensureTitle	(	$row,
		$queryFlags,
		$title = null )

private

Make sure we have some Title object for use by the constructor.

For B/C, the constructor shouldn't fail even for a bad page ID or bad revision ID.

Parameters

array \| object	$row
int	$queryFlags
Title \| null	$title

Returns: Title $title if not null, or a Title constructed from information in $row.

Definition at line 591 of file Revision.php.

References $title, and(), getRevisionStore(), NS_SPECIAL, and wfLogWarning().

Referenced by __construct().

◆ getArchiveQueryInfo()

static Revision::getArchiveQueryInfo ( )

static

Return the tables, fields, and join conditions to be selected to create a new archived revision object.

Since: 1.31

Deprecated: since 1.31, use RevisionStore::getArchiveQueryInfo() instead.

Returns

array With three keys:

tables: (string[]) to include in the $table to IDatabase->select()
fields: (string[]) to include in the $vars to IDatabase->select()
joins: (array) to include in the $join_conds to IDatabase->select()

Definition at line 525 of file Revision.php.

References getRevisionStore().

Referenced by DifferenceEngine\deletedLink(), PopulateRevisionLength\doDBUpdates(), PopulateRevisionSha1\doDBUpdates(), RevDelArchiveList\doQuery(), RevDelRevisionList\doQuery(), PopulateRevisionSha1\doSha1LegacyUpdates(), RevisionDbTestBase\testNewFromArchiveRow(), RevisionDbTestBase\testNewFromArchiveRowOverrides(), MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionGetArchiveQueryInfo(), and PageArchiveTestBase\testUndeleteRevisions().

◆ getBlobStore()

static Revision::getBlobStore ( $wiki = false )

staticprotected

Parameters

bool | string $wiki The ID of the target wiki database. Use false for the local wiki.

Returns: SqlBlobStore

Definition at line 91 of file Revision.php.

References and().

Referenced by compressRevisionText(), decompressRevisionText(), getRevisionText(), and getTextId().

◆ getComment()

Revision::getComment	(		$audience = self::FOR_PUBLIC,
		User	$user = null )

Parameters

int	$audience	One of: Revision::FOR_PUBLIC to be displayed to all users Revision::FOR_THIS_USER to be displayed to the given user Revision::RAW get the text regardless of permissions
User \| null	$user	User object to check for, only if FOR_THIS_USER is passed to the $audience parameter

Returns: string|null Returns null if the specified audience does not have access to the comment.

Definition at line 845 of file Revision.php.

References and(), and null.

Referenced by MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ getContent()

Revision::getContent	(		$audience = self::FOR_PUBLIC,
		User	$user = null )

Fetch revision content if it's available to the specified audience.

If the specified audience does not have the ability to view this revision, or the content could not be loaded, null will be returned.

Parameters

int	$audience	One of: Revision::FOR_PUBLIC to be displayed to all users Revision::FOR_THIS_USER to be displayed to $user Revision::RAW get the text regardless of permissions
User \| null	$user	User object to check for, only if FOR_THIS_USER is passed to the $audience parameter

Since: 1.21

Returns: Content|null

Definition at line 915 of file Revision.php.

References $e, and and().

Referenced by BenchmarkParse\runParser().

◆ getContentFormat()

Revision::getContentFormat ( )

Returns the content format for the main slot of this revision.

If no content format was stored in the database, the default format for this revision's content model is returned.

Todo: drop this, the format is irrelevant to the revision!

Returns: string The content format id associated with this revision, see the CONTENT_FORMAT_XXX constants.

Definition at line 970 of file Revision.php.

References getContentHandler(), and getMainSlotRaw().

Referenced by RevisionDbTestBase\assertRevEquals(), and MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ getContentHandler()

Revision::getContentHandler ( )

Returns the content handler appropriate for this revision's content model.

Exceptions

MWException

Returns: ContentHandler

Definition at line 987 of file Revision.php.

References getContentModel().

Referenced by getContentFormat(), and WikiPage\getUndoContent().

◆ getContentModel()

Revision::getContentModel ( )

Returns the content model for the main slot of this revision.

If no content model was stored in the database, the default content model for the title is used to determine the content model to use. If no title is know, CONTENT_MODEL_WIKITEXT is used as a last resort.

Todo: drop this, with MCR, there no longer is a single model associated with a revision.

Returns: string The content model id associated with this revision, see the CONTENT_MODEL_XXX constants.

Definition at line 955 of file Revision.php.

References getMainSlotRaw().

Referenced by RevisionDbTestBase\assertRevEquals(), MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision(), and getContentHandler().

◆ getId()

Revision::getId ( )

Get revision ID.

Returns: int|null

Definition at line 638 of file Revision.php.

Referenced by RevisionDbTestBase\assertRevEquals(), MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision(), CategoryMembershipChange\notifyCategorization(), and BenchmarkParse\runParser().

◆ getMainSlotRaw()

Revision::getMainSlotRaw ( )

private

Returns: SlotRecord

Definition at line 688 of file Revision.php.

Referenced by getContentFormat(), getContentModel(), getSerializedData(), and getTextId().

◆ getNext()

Revision::getNext ( )

Get next revision for this title.

Returns: Revision|null

Definition at line 1021 of file Revision.php.

References getRevisionLookup(), and getTitle().

◆ getPage()

Revision::getPage ( )

Get the page ID.

Returns: int|null

Definition at line 782 of file Revision.php.

Referenced by RevisionDbTestBase\assertRevEquals(), and MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ getParentId()

Revision::getParentId ( )

Get parent revision ID (the original previous page revision)

Returns: int|null The ID of the parent revision. 0 indicates that there is no parent revision. Null indicates that the parent revision is not known.

Definition at line 717 of file Revision.php.

◆ getParentLengths()

static Revision::getParentLengths	(		$db,
		array	$revIds )

static

Do a batched query to get the parent revision lengths.

Deprecated: in 1.31, use RevisionStore::getRevisionSizes instead.

Parameters

IDatabase	$db
array	$revIds

Returns: array

Definition at line 538 of file Revision.php.

References getRevisionStore().

Referenced by HistoryPager\doBatchLookups(), ContribsPager\doBatchLookups(), RevisionDbTestBase\testGetParentLengths_multipleRevIds(), RevisionDbTestBase\testGetParentLengths_noRevIds(), and RevisionDbTestBase\testGetParentLengths_oneRevId().

◆ getPrevious()

Revision::getPrevious ( )

Get previous revision for this title.

Returns: Revision|null

Definition at line 1010 of file Revision.php.

References getRevisionLookup(), and getTitle().

◆ getQueryInfo()

static Revision::getQueryInfo ( $options = [] )

static

Return the tables, fields, and join conditions to be selected to create a new revision object.

Since: 1.31

Deprecated: since 1.31, use RevisionStore::getQueryInfo() instead.

Parameters

array

$options

Any combination of the following strings

'page': Join with the page table, and select fields to identify the page
'user': Join with the user table, and select the user name
'text': Join with the text table, and select fields to load page text

Returns

array With three keys:

tables: (string[]) to include in the $table to IDatabase->select()
fields: (string[]) to include in the $vars to IDatabase->select()
joins: (array) to include in the $join_conds to IDatabase->select()

Definition at line 511 of file Revision.php.

References $options, and getRevisionStore().

Referenced by WikiPage\archiveRevisions(), WikiExporter\do_list_authors(), PopulateRevisionLength\doDBUpdates(), PopulateRevisionSha1\doDBUpdates(), ChangeTagsRevisionList\doQuery(), RevDelRevisionList\doQuery(), RevisionList\doQuery(), WikiExporter\dumpPages(), HistoryAction\fetchRevisions(), BaseBlacklist\getArticleText(), Title\getAuthorsBetween(), ContentHandler\getAutoDeleteReason(), Title\getFirstRevision(), HistoryPager\getQueryInfo(), ContribsPager\getQueryInfo(), MergeHistoryPager\getQueryInfo(), Linker\getRollbackEditCount(), RebuildTextIndex\populateSearchIndex(), CategoryMembershipChangeJob\run(), RevisionDbTestBase\testGetRevisionText(), RevisionDbTestBase\testNewFromRow(), MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionGetQueryInfo(), PageArchiveTestBase\testUndeleteRevisions(), ImportTest\testUnknownUserHandling(), and RevisionDbTestBase\testUserWasLastToEdit().

◆ getRecentChange()

Revision::getRecentChange ( $flags = 0 )

Get the RC object belonging to the current revision, if there's one.

Parameters

int $flags (optional) $flags include: Revision::READ_LATEST : Select the data from the master

Since: 1.22

Returns: RecentChange|null

Definition at line 879 of file Revision.php.

References getRevisionStore().

◆ getRevisionFactory()

static Revision::getRevisionFactory ( )

staticprotected

Returns: RevisionFactory

Definition at line 82 of file Revision.php.

Referenced by __construct(), newFromArchiveRow(), and newFromRow().

◆ getRevisionLookup()

static Revision::getRevisionLookup ( )

staticprotected

Returns: RevisionLookup

Definition at line 75 of file Revision.php.

Referenced by getNext(), getPrevious(), newFromId(), newFromPageId(), newFromTitle(), and newKnownCurrent().

◆ getRevisionRecord()

Revision::getRevisionRecord ( )

Returns: RevisionRecord

Definition at line 629 of file Revision.php.

References $mRecord.

Referenced by WikiPage\doEditUpdates().

◆ getRevisionStore()

static Revision::getRevisionStore ( $wiki = false )

staticprotected

Returns: RevisionStore

Definition at line 63 of file Revision.php.

Referenced by countByPageId(), countByTitle(), ensureTitle(), getArchiveQueryInfo(), getParentLengths(), getQueryInfo(), getRecentChange(), getRevisionText(), getTimestampFromId(), insertOn(), isUnpatrolled(), loadFromId(), loadFromPageId(), loadFromTimestamp(), loadFromTitle(), newNullRevision(), and userWasLastToEdit().

◆ getRevisionText()

static Revision::getRevisionText	(	$row,
		$prefix = 'old_',
		$wiki = false )

static

Get revision text associated with an old or archive row.

If the text field is not included, this uses RevisionStore to load the appropriate slot and return its serialized content. This is the default backwards-compatibility behavior when reading from the MCR aware database schema is enabled. For this to work, either the revision ID or the page ID must be included in the row.

When using the old text field, the flags field must also be set. Including the old_id field will activate cache usage as long as the $wiki parameter is not set.

Deprecated: since 1.32, use RevisionStore::newRevisionFromRow instead.

Parameters

stdClass	$row	The text data. If a falsy value is passed instead, false is returned.
string	$prefix	Table prefix (default 'old_')
string \| bool	$wiki	The name of the wiki to load the revision text from (same as the wiki $row was loaded from) or false to indicate the local wiki (this is the default). Otherwise, it must be a symbolic wiki database identifier as understood by the LoadBalancer class.

Returns: string|false Text the text requested or false on failure

Definition at line 1048 of file Revision.php.

References $content, $rev, $wgMultiContentRevisionSchemaMigrationStage, and(), getBlobStore(), getRevisionStore(), SCHEMA_COMPAT_WRITE_OLD, wfDeprecated(), and wfLogWarning().

Referenced by CompressOld\compressWithConcat(), MigrateArchiveText\doDBUpdates(), RecompressTracked\doOrphanList(), RecompressTracked\doPage(), ApiQueryDeletedrevs\execute(), RevisionTest\testCompressRevisionTextUtf8(), RevisionTest\testCompressRevisionTextUtf8Gzip(), RevisionTest\testGetRevisionText(), RevisionDbTestBase\testGetRevisionText(), RevisionTest\testGetRevisionText_external_noOldId(), RevisionTest\testGetRevisionText_external_oldId(), RevisionTest\testGetRevisionText_external_returnsFalseWhenNotEnoughUrlParts(), RevisionTest\testGetRevisionText_returnsDecompressedTextFieldWhenNotExternal(), RevisionTest\testGetRevisionWithZlibExtension_badData(), and XmlDumpWriter\writeRevision().

◆ getSerializedData()

Revision::getSerializedData ( )

Get original serialized data (without checking view restrictions)

Since: 1.21

Deprecated: since 1.31, use BlobStore::getBlob instead.

Returns: string

Definition at line 938 of file Revision.php.

References getMainSlotRaw().

◆ getSha1()

Revision::getSha1 ( )

Returns the base36 sha1 of the content in this revision, or null if unknown.

Returns: string|null

Definition at line 739 of file Revision.php.

Referenced by RevisionDbTestBase\assertRevEquals(), and MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ getSize()

Revision::getSize ( )

Returns the length of the text in this revision, or null if unknown.

Returns: int|null

Definition at line 726 of file Revision.php.

Referenced by MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ getTextId()

Revision::getTextId ( )

Get the ID of the row of the text table that contains the content of the revision's main slot, if that content is stored in the text table.

If the content is stored elsewhere, this returns null.

Deprecated: since 1.31, use RevisionRecord()->getSlot()->getContentAddress() to get that actual address that can be used with BlobStore::getBlob(); or use RevisionRecord::hasSameContent() to check if two revisions have the same content.

Returns: int|null

Definition at line 704 of file Revision.php.

References getBlobStore(), and getMainSlotRaw().

◆ getTimestamp()

Revision::getTimestamp ( )

Returns: string

Definition at line 994 of file Revision.php.

Referenced by CategoryMembershipChange\__construct(), RevisionDbTestBase\assertRevEquals(), MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision(), and WikiPage\setLastEdit().

◆ getTimestampFromId()

static Revision::getTimestampFromId	(	$title,
		$id,
		$flags = 0 )

static

Get rev_timestamp from rev_id, without loading the rest of the row.

Parameters

Title	$title
int	$id
int	$flags

Returns: string|bool False if not found

Definition at line 1264 of file Revision.php.

References getRevisionStore().

Referenced by Skin\lastModified().

◆ getTitle()

Revision::getTitle ( )

Returns the title of the page associated with this entry.

Since 1.31, this will never return null.

Will do a query, when title is not set and id is given.

Returns: Title

Definition at line 755 of file Revision.php.

Referenced by MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision(), getNext(), getPrevious(), and BenchmarkParse\runParser().

◆ getUser()

Revision::getUser	(		$audience = self::FOR_PUBLIC,
		User	$user = null )

Fetch revision's user id if it's available to the specified audience.

If the specified audience does not have access to it, zero will be returned.

Parameters

int	$audience	One of: Revision::FOR_PUBLIC to be displayed to all users Revision::FOR_THIS_USER to be displayed to the given user Revision::RAW get the ID regardless of permissions
User \| null	$user	User object to check for, only if FOR_THIS_USER is passed to the $audience parameter

Returns: int

Definition at line 799 of file Revision.php.

References and().

Referenced by RevisionDbTestBase\assertRevEquals(), and MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ getUserText()

Revision::getUserText	(		$audience = self::FOR_PUBLIC,
		User	$user = null )

Fetch revision's username if it's available to the specified audience.

If the specified audience does not have access to the username, an empty string will be returned.

Parameters

int	$audience	One of: Revision::FOR_PUBLIC to be displayed to all users Revision::FOR_THIS_USER to be displayed to the given user Revision::RAW get the text regardless of permissions
User \| null	$user	User object to check for, only if FOR_THIS_USER is passed to the $audience parameter

Returns: string

Definition at line 823 of file Revision.php.

References and().

Referenced by MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ getVisibility()

Revision::getVisibility ( )

Get the deletion bitfield of the revision.

Returns: int

Definition at line 897 of file Revision.php.

Referenced by MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision(), CategoryMembershipChange\notifyCategorization(), and userCan().

◆ insertOn()

Revision::insertOn ( $dbw )

Insert a new revision into the database, returning the new revision ID number on success and dies horribly on failure.

Parameters

IDatabase $dbw (master connection)

Exceptions

MWException

Returns: int The revision ID

Definition at line 1152 of file Revision.php.

References and(), and getRevisionStore().

◆ isCurrent()

Revision::isCurrent ( )

Returns: bool

Definition at line 1001 of file Revision.php.

Referenced by DifferenceEngine\getRevisionHeader().

◆ isDeleted()

Revision::isDeleted ( $field )

Parameters

int $field One of DELETED_* bitfield constants

Returns: bool

Definition at line 888 of file Revision.php.

◆ isMinor()

Revision::isMinor ( )

Returns: bool

Definition at line 859 of file Revision.php.

Referenced by MediaWiki\Tests\Revision\RevisionStoreDbTestBase\assertRevisionRecordMatchesRevision().

◆ isUnpatrolled()

Revision::isUnpatrolled ( )

Returns: int Rcid of the unpatrolled row, zero if there isn't one

Definition at line 866 of file Revision.php.

References getRevisionStore().

◆ loadFromId()

static Revision::loadFromId	(		$db,
			$id )

static

Load a page revision from a given revision ID number.

Returns null if no such revision can be found.

Deprecated: since 1.31, use RevisionStore::getRevisionById() instead.

Parameters

IDatabase	$db
int	$id

Returns: Revision|null

Definition at line 242 of file Revision.php.

References getRevisionStore(), and wfDeprecated().

Referenced by RevisionDbTestBase\testLoadFromId().

◆ loadFromPageId()

static Revision::loadFromPageId	(	$db,
		$pageid,
		$id = 0 )

static

Load either the current, or a specified, revision that's attached to a given page.

If not attached to that page, will return null.

Deprecated: since 1.31, use RevisionStore::getRevisionByPageId() instead.

Parameters

IDatabase	$db
int	$pageid
int	$id

Returns: Revision|null

Definition at line 260 of file Revision.php.

References getRevisionStore().

Referenced by Cleanup\execute(), RevisionDbTestBase\testLoadFromPageId(), RevisionDbTestBase\testLoadFromPageIdWithLatestRevId(), RevisionDbTestBase\testLoadFromPageIdWithNotLatestRevId(), and Maintenance\updateSearchIndexForPage().

◆ loadFromTimestamp()

static Revision::loadFromTimestamp	(	$db,
		$title,
		$timestamp )

static

Load the revision for the given title with the given timestamp.

WARNING: Timestamps may in some circumstances not be unique, so this isn't the best key to use.

Deprecated: since 1.31, use RevisionStore::getRevisionByTimestamp() or RevisionStore::loadRevisionFromTimestamp() instead.

Parameters

IDatabase	$db
Title	$title
string	$timestamp

Returns: Revision|null

Definition at line 295 of file Revision.php.

References getRevisionStore().

Referenced by AttachLatest\execute(), EditPage\getBaseRevision(), User\getNewMessageLinks(), WikiPage\replaceSectionContent(), and RevisionDbTestBase\testLoadFromTimestamp().

◆ loadFromTitle()

static Revision::loadFromTitle	(	$db,
		$title,
		$id = 0 )

static

Load either the current, or a specified, revision that's attached to a given page.

If not attached to that page, will return null.

Deprecated: since 1.31, use RevisionStore::getRevisionByTitle() instead.

Parameters

IDatabase	$db
Title	$title
int	$id

Returns: Revision|null

Definition at line 277 of file Revision.php.

References getRevisionStore().

Referenced by EditPage\mergeChangesIntoContent(), RevisionDbTestBase\testLoadFromTitle(), RevisionTest\testLoadFromTitle(), RevisionDbTestBase\testLoadFromTitleWithLatestRevId(), and RevisionDbTestBase\testLoadFromTitleWithNotLatestRevId().

◆ newFromArchiveRow()

static Revision::newFromArchiveRow	(		$row,
			$overrides = [] )

static

Make a fake revision object from an archive table row.

This is queried for permissions or even inserted (as in Special:Undelete)

Parameters

object	$row
array	$overrides

Exceptions

MWException

Returns: Revision

Definition at line 171 of file Revision.php.

References and(), and getRevisionFactory().

Referenced by DifferenceEngine\deletedLink(), SpecialUndelete\formatRevisionRow(), DeletedContribsPager\formatRow(), RevDelArchiveItem\initRevision(), RevisionDbTestBase\testNewFromArchiveRow(), RevisionDbTestBase\testNewFromArchiveRowOverrides(), PopulateRevisionSha1\upgradeLegacyArchiveRow(), PopulateRevisionLength\upgradeRow(), and PopulateRevisionSha1\upgradeRow().

◆ newFromId()

static Revision::newFromId	(		$id,
			$flags = 0 )

static

Load a page revision from a given revision ID number.

Returns null if no such revision can be found.

$flags include: Revision::READ_LATEST : Select the data from the master Revision::READ_LOCKING : Select & lock the data from the master

Parameters

int	$id
int	$flags	(optional)

Returns: Revision|null

Definition at line 118 of file Revision.php.

References getRevisionLookup().

Referenced by SpecialComparePages\checkExistingRevision(), Orphans\checkSeparation(), User\clearNotification(), EditPage\edit(), ApiEditPage\execute(), ApiParse\execute(), BenchmarkParse\execute(), CheckBadRedirects\execute(), ImportTextFiles\execute(), SpecialNewpages\feedItemDesc(), Article\fetchRevisionRecord(), FeedUtils\formatDiffRow(), EditPage\getBaseRevision(), EditPage\getContentObject(), Article\getOldIDFromRequest(), CategoryMembershipChange\getPreviousRevisionTimestamp(), Parser\getRevisionObject(), DifferenceEngine\loadRevisionData(), CategoryMembershipChangeJob\notifyUpdatesForRevision(), MediaWiki\parseTitle(), WikiPage\replaceSectionAtRev(), MediaWikiTestCase\revisionDelete(), Article\setOldSubtitle(), SpecialComparePages\showDiff(), Parser\statelessFetchTemplate(), RevDelRevisionList\suggestTarget(), CategoryMembershipChangeTest\testChangeAddedWithRev(), CategoryMembershipChangeTest\testChangeRemovedWithRev(), RevisionDbTestBase\testGetPage(), ApiRevisionDeleteTest\testHidingRevisions(), RevisionDbTestBase\testIsCurrent(), RevisionDbTestBase\testNewFromId(), and ChangeTags\updateTagsWithChecks().

◆ newFromPageId()

static Revision::newFromPageId	(	$pageId,
		$revId = 0,
		$flags = 0 )

static

Load either the current, or a specified, revision that's attached to a given page ID.

Returns null if no such revision can be found.

$flags include: Revision::READ_LATEST : Select the data from the master (since 1.20) Revision::READ_LOCKING : Select & lock the data from the master

Parameters

int	$pageId
int	$revId	(optional)
int	$flags	Bitfield (optional)

Returns: Revision|null

Definition at line 156 of file Revision.php.

References getRevisionLookup().

Referenced by NamespaceDupes\canMerge(), ApiStashEdit\execute(), WikiPage\loadLastEdit(), RevisionDbTestBase\testNewFromPageId(), RevisionDbTestBase\testNewFromPageIdWithLatestId(), and RevisionDbTestBase\testNewFromPageIdWithNotLatestId().

◆ newFromRow()

static Revision::newFromRow ( $row )

static

Since: 1.19

MCR migration note: replaced by RevisionStore::newRevisionFromRow(). Note that newFromRow() also accepts arrays, while newRevisionFromRow() does not. Instead, a MutableRevisionRecord should be constructed directly. RevisionStore::newMutableRevisionFromArray() can be used as a temporary replacement, but should be avoided.

Parameters

object | array $row

Returns: Revision

Definition at line 222 of file Revision.php.

References and(), and getRevisionFactory().

Referenced by BaseBlacklist\getArticleText(), CategoryMembershipChangeJob\run(), and RevisionDbTestBase\testNewFromRow().

◆ newFromTitle()

static Revision::newFromTitle	(	LinkTarget	$linkTarget,
			$id = 0,
			$flags = 0 )

static

Load either the current, or a specified, revision that's attached to a given link target.

If not attached to that link target, will return null.

$flags include: Revision::READ_LATEST : Select the data from the master Revision::READ_LOCKING : Select & lock the data from the master

Parameters

LinkTarget	$linkTarget
int	$id	(optional)
int	$flags	Bitfield (optional)

Returns: Revision|null

Definition at line 137 of file Revision.php.

References getRevisionLookup().

Referenced by ApiMoveTest\assertMoved(), NamespaceDupes\canMerge(), CleanupSpam\cleanupArticle(), Title\countRevisionsBetween(), ApiEditPage\execute(), BenchmarkParse\execute(), GetTextMaint\execute(), MediaWikiGadgetsDefinitionRepo\fetchStructuredList(), Title\getAuthorsBetween(), ContentHandler\getAutoDeleteReason(), GadgetDefinitionNamespaceRepo\getGadget(), Skin\getNewtalks(), RawAction\getRawText(), FixDefaultJsonContentPages\handleRow(), SearchResult\initFromTitle(), InfoAction\invalidateCache(), Title\isValidMoveTarget(), MovePage\isValidMoveTarget(), DifferenceEngine\loadRevisionData(), SimpleCaptcha\loadText(), LanguageConverter\parseCachedTable(), DoubleRedirectJob\run(), SpecialCiteThisPage\showCitations(), SpecialBookSources\showList(), Parser\statelessFetchTemplate(), ApiQueryRecentChangesIntegrationTest\testCategorizeTypeParameter(), ApiQueryWatchlistIntegrationTest\testCategorizeTypeParameter(), RevisionDbTestBase\testNewFromTitle_withBadId(), RevisionDbTestBase\testNewFromTitle_withId(), RevisionDbTestBase\testNewFromTitle_withoutId(), and SpecialChangeContentModel\validateTitle().

◆ newKnownCurrent()

static Revision::newKnownCurrent	(	IDatabase	$db,
			$pageIdOrTitle,
			$revId = 0 )

static

Load a revision based on a known page ID and current revision ID from the DB.

This method allows for the use of caching, though accessing anything that normally requires permission checks (aside from the text) will trigger a small DB lookup. The title will also be loaded if $pageIdOrTitle is an integer ID.

Parameters

IDatabase	$db	ignored!
int \| Title	$pageIdOrTitle	Page ID or Title object
int	$revId	Known current revision of this page. Determined automatically if not given.

Returns: Revision|bool Returns false if missing

Since: 1.28

Definition at line 1327 of file Revision.php.

References and(), and getRevisionLookup().

Referenced by ResourceLoaderWikiModule\getContentObj(), MessageCache\loadCachedMessagePageEntry(), WikiPage\loadLastEdit(), Parser\statelessFetchRevision(), RevisionDbTestBase\testNewKnownCurrent(), RevisionDbTestBase\testNewKnownCurrent_returnsFalseWhenTitleDoesntExist(), and RevisionDbTestBase\testNewKnownCurrent_withPageId().

◆ newNullRevision()

static Revision::newNullRevision	(	$dbw,
		$pageId,
		$summary,
		$minor,
		$user = null )

static

Create a new null-revision for insertion into a page's history.

This will not re-save the text, but simply refer to the text from the previous version.

Such revisions can for instance identify page rename operations and other such meta-modifications.

Parameters

IDatabase	$dbw
int	$pageId	ID number of the page to read from
string	$summary	Revision's summary
bool	$minor	Whether the revision should be considered as minor
User \| null	$user	User object to use or null for $wgUser

Returns: Revision|null Revision or null on error

Definition at line 1198 of file Revision.php.

References and(), and getRevisionStore().

Referenced by WikiPage\insertProtectNullRevision(), MovePage\moveToInternal(), LocalFile\recordUpload2(), ImportReporter\reportPage(), RevisionDbTestBase\testNewNullRevision(), and RevisionDbTestBase\testNewNullRevision_badPage().

◆ pageJoinCond()

static Revision::pageJoinCond ( )

static

Return the value of a select() page conds array for the page table.

This will assure that the revision(s) are not orphaned from live pages.

Since: 1.19

Deprecated: since 1.31, use RevisionStore::getQueryInfo( [ 'page' ] ) instead.

Returns: array

Definition at line 331 of file Revision.php.

References wfDeprecated().

Referenced by MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionPageJoinCond().

◆ selectArchiveFields()

static Revision::selectArchiveFields ( )

static

Return the list of revision fields that should be selected to create a new revision from an archive row.

Deprecated: since 1.31, use RevisionStore::getArchiveQueryInfo() instead.

Returns: array

Definition at line 402 of file Revision.php.

References $wgActorTableSchemaMigrationStage, $wgContentHandlerUseDB, $wgMultiContentRevisionSchemaMigrationStage, SCHEMA_COMPAT_READ_NEW, SCHEMA_COMPAT_WRITE_OLD, and wfDeprecated().

Referenced by MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionSelectArchiveFields().

◆ selectFields()

static Revision::selectFields ( )

static

Return the list of revision fields that should be selected to create a new revision.

Deprecated: since 1.31, use RevisionStore::getQueryInfo() instead.

Returns: array

Definition at line 342 of file Revision.php.

References $wgActorTableSchemaMigrationStage, $wgContentHandlerUseDB, $wgMultiContentRevisionSchemaMigrationStage, SCHEMA_COMPAT_READ_NEW, SCHEMA_COMPAT_WRITE_OLD, and wfDeprecated().

Referenced by BaseBlacklist\getArticleText(), and MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionSelectFields().

◆ selectPageFields()

static Revision::selectPageFields ( )

static

Return the list of page fields that should be selected from page table.

Deprecated: since 1.31, use RevisionStore::getQueryInfo( [ 'page' ] ) instead.

Returns: array

Definition at line 475 of file Revision.php.

References wfDeprecated().

Referenced by BaseBlacklist\getArticleText(), and MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionSelectPageFields().

◆ selectTextFields()

static Revision::selectTextFields ( )

static

Return the list of text fields that should be selected to read the revision text.

Deprecated: since 1.31, use RevisionStore::getQueryInfo( [ 'text' ] ) instead.

Returns: array

Definition at line 462 of file Revision.php.

References wfDeprecated().

Referenced by BaseBlacklist\getArticleText(), and MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionSelectTextFields().

◆ selectUserFields()

static Revision::selectUserFields ( )

static

Return the list of user fields that should be selected from user table.

Deprecated: since 1.31, use RevisionStore::getQueryInfo( [ 'user' ] ) instead.

Returns: array

Definition at line 492 of file Revision.php.

References wfDeprecated().

Referenced by MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionSelectUserFields().

◆ setId()

Revision::setId ( $id )

Set the revision ID.

This should only be used for proposed revisions that turn out to be null edits.

Note: Only supported on Revisions that were constructed based on associative arrays, since they are mutable.

Since: 1.19

Parameters

int | string $id

Exceptions

MWException

Definition at line 654 of file Revision.php.

References and().

◆ setTitle()

Revision::setTitle ( $title )

Set the title of the revision.

Deprecated: since 1.31, this is now a noop. Pass the Title to the constructor instead.

Parameters

Title $title

Definition at line 767 of file Revision.php.

◆ setUserIdAndName()

Revision::setUserIdAndName	(		$id,
			$name )

Set the user ID/name.

This should only be used for proposed revisions that turn out to be null edits

Note: Only supported on Revisions that were constructed based on associative arrays, since they are mutable.

Since: 1.28

Deprecated: since 1.31, please reuse old Revision object

Parameters

int	$id	User ID
string	$name	User name

Exceptions

MWException

Definition at line 676 of file Revision.php.

References and(), and User\newFromAnyId().

◆ userCan()

Revision::userCan	(		$field,
		User	$user = null )

Determine if the current user is allowed to view a particular field of this revision, if it's marked as deleted.

Parameters

int	$field	One of self::DELETED_TEXT, self::DELETED_COMMENT, self::DELETED_USER
User \| null	$user	User object to check, or null to use $wgUser

Returns: bool

Definition at line 1226 of file Revision.php.

References getVisibility(), and userCanBitfield().

◆ userCanBitfield()

static Revision::userCanBitfield	(		$bitfield,
			$field,
		User	$user = null,
		Title	$title = null )

static

Determine if the current user is allowed to view a particular field of this revision, if it's marked as deleted.

This is used by various classes to avoid duplication.

Parameters

int	$bitfield	Current field
int	$field	One of self::DELETED_TEXT = File::DELETED_FILE, self::DELETED_COMMENT = File::DELETED_COMMENT, self::DELETED_USER = File::DELETED_USER
User \| null	$user	User object to check, or null to use $wgUser
Title \| null	$title	A Title object to check for per-page restrictions on, instead of just plain userrights

Returns: bool

Definition at line 1244 of file Revision.php.

References and().

Referenced by ApiQueryDeletedrevs\execute(), RevisionDbTestBase\testUserCanBitfield(), ArchivedFile\userCan(), OldLocalFile\userCan(), userCan(), and ChangesList\userCan().

◆ userJoinCond()

static Revision::userJoinCond ( )

static

Return the value of a select() JOIN conds array for the user table.

This will get user table rows for logged-in users.

Since: 1.19

Deprecated: since 1.31, use RevisionStore::getQueryInfo( [ 'user' ] ) instead.

Returns: array

Definition at line 307 of file Revision.php.

References $wgActorTableSchemaMigrationStage, SCHEMA_COMPAT_READ_NEW, and wfDeprecated().

Referenced by MediaWiki\Tests\Revision\RevisionQueryInfoTest\testRevisionUserJoinCond().

◆ userWasLastToEdit()

static Revision::userWasLastToEdit	(	$db,
		$pageId,
		$userId,
		$since )

static

Check if no edits were made by other users since the time a user started editing the page.

Limit to 50 revisions for the sake of performance.

Since: 1.20

Deprecated: since 1.24

Parameters

IDatabase \| int	$db	The Database to perform the check on. May be given as a Database object or a database identifier usable with wfGetDB.
int	$pageId	The ID of the page in question
int	$userId	The ID of the user in question
string	$since	Look at edits since this time

Returns: bool True if the given user was the only one to edit since the given timestamp

Definition at line 1306 of file Revision.php.

References and(), getRevisionStore(), and wfGetDB().

Referenced by EditPage\internalAttemptSave(), and RevisionDbTestBase\testUserWasLastToEdit().

Member Data Documentation

◆ $mRecord

RevisionRecord Revision::$mRecord

protected

Definition at line 43 of file Revision.php.

Referenced by getRevisionRecord().

◆ DELETED_COMMENT

const Revision::DELETED_COMMENT = RevisionRecord::DELETED_COMMENT

Definition at line 47 of file Revision.php.

Referenced by ApiComparePagesTest\addDBDataOnce(), SpecialRevisionDelete\execute(), ApiQueryDeletedrevs\execute(), FeedUtils\formatDiff(), RevDelArchivedFileItem\getApiData(), RevDelFileItem\getApiData(), RevDelRevisionItem\getApiData(), RevisionDeleter\getChanges(), DeleteLogFormatter\getParametersForApi(), ChangesList\insertComment(), RevisionDbTestBase\provideUserCan(), RevisionDbTestBase\provideUserCanBitfield(), Linker\revComment(), RevisionDbTestBase\testIsDeleted_nothingDeleted(), and XmlDumpWriter\writeRevision().

◆ DELETED_RESTRICTED

const Revision::DELETED_RESTRICTED = RevisionRecord::DELETED_RESTRICTED

Definition at line 49 of file Revision.php.

Referenced by ApiComparePagesTest\addDBDataOnce(), ApiParseTest\addDBDataOnce(), SpecialRevisionDelete\buildCheckBoxes(), RevDelLogItem\canView(), RevDelRevisionItem\canView(), RevisionItem\canView(), SpecialRevisionDelete\execute(), ApiQueryDeletedrevs\execute(), SpecialRevisionDelete\extractBitParams(), RevisionDeleter\getChanges(), DeleteLogFormatter\getParametersForApi(), ApiParse\getParsedContent(), Linker\getRevDeleteLink(), RevDelLogList\getSuppressBit(), RevDelRevisionList\getSuppressBit(), WatchedItemQueryService\getUserRelatedConds(), HistoryPager\historyLine(), RevisionDbTestBase\provideUserCan(), RevisionDbTestBase\provideUserCanBitfield(), RevisionDeleteUser\setUsernameBitfields(), RevDelList\setVisibility(), Article\showDeletedRevisionHeader(), DifferenceEngine\showDiffPage(), SpecialUndelete\showRevision(), SpecialRevisionDelete\submit(), RevisionDbTestBase\testIsDeleted_nothingDeleted(), and WatchedItemQueryServiceUnitTest\userPermissionRelatedExtraChecksProvider().

◆ DELETED_TEXT

const Revision::DELETED_TEXT = RevisionRecord::DELETED_TEXT

Definition at line 46 of file Revision.php.

Referenced by ApiComparePagesTest\addDBDataOnce(), ApiParseTest\addDBDataOnce(), RevDelRevisionItem\canViewContent(), RevisionItem\canViewContent(), CleanupSpam\cleanupArticle(), HistoryPager\curLink(), HistoryPager\diffButtons(), ApiEditPage\execute(), ApiParse\execute(), ApiQueryDeletedrevs\execute(), Article\fetchRevisionRecord(), DeletedContribsPager\formatRevisionRow(), SpecialMergeHistory\formatRevisionRow(), SpecialUndelete\formatRevisionRow(), ContribsPager\formatRow(), RevDelRevisionItem\getApiData(), ChangesList\getArticleLink(), RevisionDeleter\getChanges(), EditPage\getContentObject(), DifferenceEngine\getDiffBody(), EnhancedChangesList\getLineData(), EnhancedChangesList\getLogText(), SpecialUndelete\getPageLink(), DeleteLogFormatter\getParametersForApi(), ApiParse\getParsedContent(), RevDelRevisionList\getRevdelConstant(), DifferenceEngine\getRevisionHeader(), Linker\getRollbackEditCount(), HistoryPager\historyLine(), ChangesList\insertDiffHist(), RevDelRevisionItem\isDeleted(), RevisionItem\isDeleted(), RevDelRevisionItem\isHideCurrentOp(), HistoryPager\lastLink(), RevisionTest\provideConstructFromRow(), RevisionDbTestBase\provideUserCan(), RevisionDbTestBase\provideUserCanBitfield(), ChangesList\revDateLink(), Article\showDeletedRevisionHeader(), RCCacheEntryFactory\showDiffLinks(), DifferenceEngine\showDiffPage(), EditPage\showHeader(), SpecialUndelete\showRevision(), RevisionDbTestBase\testIsDeleted_nothingDeleted(), ApiEditPageTest\testUndoAfterToHiddenRev(), and XmlDumpWriter\writeRevision().

◆ DELETED_USER

const Revision::DELETED_USER = RevisionRecord::DELETED_USER

Definition at line 48 of file Revision.php.

Referenced by ApiComparePagesTest\addDBDataOnce(), ChangesFeed\buildItems(), WikiExporter\do_list_authors(), SpecialRevisionDelete\execute(), ApiQueryDeletedrevs\execute(), DeletedContribsPager\formatRevisionRow(), ContribsPager\formatRow(), RevDelArchivedFileItem\getApiData(), RevDelFileItem\getApiData(), RevDelRevisionItem\getApiData(), ContentHandler\getAutoDeleteReason(), RevisionDeleter\getChanges(), DeleteLogFormatter\getParametersForApi(), ContribsPager\getQueryInfo(), DeletedContribsPager\getQueryInfo(), Linker\getRollbackEditCount(), RCCacheEntryFactory\getUserLink(), WatchedItemQueryService\getUserRelatedConds(), RevDelFileItem\getUserTools(), ChangesList\insertUserRelatedLinks(), RCCacheEntryFactory\newFromRecentChange(), RevisionDbTestBase\provideUserCan(), RevisionDbTestBase\provideUserCanBitfield(), Linker\revUserLink(), Linker\revUserTools(), RevisionDeleteUser\setUsernameBitfields(), RevisionDbTestBase\testIsDeleted_nothingDeleted(), WatchedItemQueryServiceUnitTest\userPermissionRelatedExtraChecksProvider(), and XmlDumpWriter\writeRevision().

◆ FOR_PUBLIC

const Revision::FOR_PUBLIC = RevisionRecord::FOR_PUBLIC

Definition at line 54 of file Revision.php.

Referenced by GetTextMaint\execute(), RevisionDbTestBase\provideGetContent(), WikiPageDbTestBase\testDoDeleteArticleReal_suppress(), and ApiRevisionDeleteTest\testHidingRevisions().

◆ FOR_THIS_USER

const Revision::FOR_THIS_USER = RevisionRecord::FOR_THIS_USER

Definition at line 55 of file Revision.php.

Referenced by ApiEditPage\execute(), Article\fetchRevisionRecord(), RevDelRevisionItem\getApiData(), EditPage\getOriginalContent(), ApiParse\getParsedContent(), RollbackAction\handleRollbackRequest(), DifferenceEngine\loadNewText(), DifferenceEngine\loadText(), InfoAction\pageInfo(), Linker\revComment(), Linker\revUserLink(), Linker\revUserTools(), and WikiPageDbTestBase\testDoDeleteArticleReal_suppress().

◆ RAW

const Revision::RAW = RevisionRecord::RAW

Definition at line 56 of file Revision.php.

Referenced by ParserTestRunner\addArticle(), CategoryMembershipChangeTest\addDBDataOnce(), CleanupSpam\cleanupArticle(), WikiPage\doDeleteArticleBatched(), GetTextMaint\execute(), ViewCLI\execute(), RefreshLinks\fixRedirect(), Title\getAuthorsBetween(), ResourceLoaderWikiModule\getContentObj(), EditPage\getContentObject(), EditPage\getCurrentContent(), WikiPage\getDeletionUpdates(), DifferenceEngine\getMultiNotice(), EditPage\getPreloadedContent(), Linker\getRollbackEditCount(), CategoryMembershipChange\getUser(), FixDefaultJsonContentPages\handleRow(), CheckStorage\importRevision(), LanguageConverter\parseCachedTable(), PreprocessDump\processRevision(), Linker\revComment(), ApiEditPageTest\testEditNewSection(), ApiEditPageTest\testEditSection(), RevisionDbTestBase\testGetContentClone(), RevisionDbTestBase\testGetContentUncloned(), RevisionTest\testSetUserIdAndName(), and PopulateRevisionLength\upgradeRow().

◆ SUPPRESSED_ALL

const Revision::SUPPRESSED_ALL = RevisionRecord::SUPPRESSED_ALL

Definition at line 51 of file Revision.php.

Referenced by WikiPage\archiveRevisions(), ChangeTagsLogItem\canView(), and LocalFileDeleteBatch\doDBInserts().

◆ SUPPRESSED_USER

const Revision::SUPPRESSED_USER = RevisionRecord::SUPPRESSED_USER

Definition at line 50 of file Revision.php.

Referenced by ContribsPager\getQueryInfo(), DeletedContribsPager\getQueryInfo(), and CategoryMembershipChange\notifyCategorization().

◆ TEXT_CACHE_GROUP

const Revision::TEXT_CACHE_GROUP = SqlBlobStore::TEXT_CACHE_GROUP

Definition at line 58 of file Revision.php.

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

includes/Revision.php

Public Member Functions

Static Public Member Functions

Public Attributes

Static Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ base36Sha1()

◆ compressRevisionText()

◆ countByPageId()

◆ countByTitle()

◆ decompressRevisionText()

◆ ensureTitle()

◆ getArchiveQueryInfo()

◆ getBlobStore()

◆ getComment()

◆ getContent()

◆ getContentFormat()

◆ getContentHandler()

◆ getContentModel()

◆ getId()

◆ getMainSlotRaw()

◆ getNext()

◆ getPage()

◆ getParentId()

◆ getParentLengths()

◆ getPrevious()

◆ getQueryInfo()

◆ getRecentChange()

◆ getRevisionFactory()

◆ getRevisionLookup()

◆ getRevisionRecord()

◆ getRevisionStore()

◆ getRevisionText()

◆ getSerializedData()

◆ getSha1()

◆ getSize()

◆ getTextId()

◆ getTimestamp()

◆ getTimestampFromId()

◆ getTitle()

◆ getUser()

◆ getUserText()

◆ getVisibility()

◆ insertOn()

◆ isCurrent()

◆ isDeleted()

◆ isMinor()

◆ isUnpatrolled()

◆ loadFromId()

◆ loadFromPageId()

◆ loadFromTimestamp()

◆ loadFromTitle()

◆ newFromArchiveRow()

◆ newFromId()

◆ newFromPageId()

◆ newFromRow()

◆ newFromTitle()

◆ newKnownCurrent()

◆ newNullRevision()

◆ pageJoinCond()

◆ selectArchiveFields()

◆ selectFields()

◆ selectPageFields()

◆ selectTextFields()

◆ selectUserFields()

◆ setId()

◆ setTitle()

◆ setUserIdAndName()

◆ userCan()

◆ userCanBitfield()

◆ userJoinCond()

◆ userWasLastToEdit()

Member Data Documentation

◆ $mRecord

◆ DELETED_COMMENT

◆ DELETED_RESTRICTED