Controller-like object for creating and updating pages by creating new revisions. More...

Collaboration diagram for MediaWiki\Storage\PageUpdater:

[legend]

Public Member Functions
	__construct (Authority $performer, WikiPage $wikiPage, DerivedPageDataUpdater $derivedDataUpdater, ILoadBalancer $loadBalancer, RevisionStore $revisionStore, SlotRoleRegistry $slotRoleRegistry, IContentHandlerFactory $contentHandlerFactory, HookContainer $hookContainer, ServiceOptions $serviceOptions, array $softwareTags)

	addTag ( $tag)
	Sets a tag to apply to this update. More...

	addTags (array $tags)
	Sets tags to apply to this update. More...

	getEditResult ()
	Returns the EditResult associated with this PageUpdater. More...

	getExplicitTags ()
	Returns the list of tags set using the addTag() method. More...

	getNewRevision ()
	The new revision created by saveRevision(), or null if saveRevision() has not yet been called, failed, or did not create a new revision because the content did not change. More...

	getStatus ()
	The Status object indicating whether saveRevision() was successful, or null if saveRevision() was not yet called on this instance. More...

	grabParentRevision ()
	Returns the revision that was the page's current revision when grabParentRevision() was first called. More...

	hasEditConflict ( $expectedParentRevision)
	Checks whether this update conflicts with another update performed between the client loading data to prepare an edit, and the client committing the edit. More...

	inheritSlot (SlotRecord $originalSlot)
	Explicitly inherit a slot from some earlier revision. More...

	isNew ()
	Whether saveRevision() was called and created a new page. More...

	isUnchanged ()
	Whether saveRevision() did not create a revision because the content didn't change (null-edit). More...

	markAsRevert (int $revertMethod, int $oldestRevertedRevId, int $newestRevertedRevId=0)
	Marks this edit as a revert and applies relevant information. More...

	removeSlot ( $role)
	Removes the slot with the given role. More...

	saveRevision (CommentStoreComment $summary, $flags=0)
	Change an existing article or create a new article. More...

	setAjaxEditStash ( $ajaxEditStash)

	setContent ( $role, Content $content)
	Set the new content for the given slot role. More...

	setOriginalRevisionId ( $originalRevId)
	Sets the ID of an earlier revision that is being repeated or restored by this update. More...

	setRcPatrolStatus ( $status)
	Sets the "patrolled" status of the edit. More...

	setSlot (SlotRecord $slot)
	Set the new slot for the given slot role. More...

	setUseAutomaticEditSummaries ( $useAutomaticEditSummaries)
	Can be used to enable or disable automatic summaries that are applied to certain kinds of changes, like completely blanking a page. More...

	setUsePageCreationLog ( $use)
	Whether to create a log entry for new page creations. More...

	updateRevision (int $revId=0)
	Updates derived slots of an existing article. More...

	wasCommitted ()
	Whether saveRevision() has been called on this instance. More...

	wasSuccessful ()
	Whether saveRevision() completed successfully. More...

Public Attributes
const	CONSTRUCTOR_OPTIONS
	Options that have to be present in the ServiceOptions object passed to the constructor. More...

Private Member Functions
	buildEditResult (RevisionRecord $revision, bool $isNew)
	Builds the EditResult for this update. More...

	checkAllRequiredRoles (array $roles, Status $status)

	checkAllRolesAllowed (array $roles, Status $status)

	checkAllRolesDerived (array $roles, Status $status)

	checkFlags ( $flags)
	Check flags and add EDIT_NEW or EDIT_UPDATE to them as needed. More...

	checkNoRolesRequired (array $roles, Status $status)

	computeEffectiveTags ( $flags)

	doCreate (CommentStoreComment $summary, UserIdentity $user, $flags)

	doModify (CommentStoreComment $summary, UserIdentity $user, $flags)

	doUpdate (UserIdentity $user, RevisionRecord $revision)
	Update derived slots in an existing revision. More...

	ensureRoleAllowed ( $role)

	ensureRoleNotRequired ( $role)

	getAllowedSlotRoles ()

	getAtomicSectionUpdate (IDatabase $dbw, WikiPage $wikiPage, RevisionRecord $newRevisionRecord, UserIdentity $user, CommentStoreComment $summary, $flags, Status $status, $hints=[])

	getContentHandler ( $role)

	getDBConnectionRef ( $mode)

	getLinkTarget ()

	getParentContent ( $role)
	Returns the content of the given slot of the parent revision, with no audience checks applied. More...

	getRequiredSlotRoles ()

	getTitle ()

	getWikiId ()

	getWikiPage ()

	makeAutoSummary ( $flags)

	makeNewRevision (CommentStoreComment $comment, UserIdentity $user, $flags, Status $status)
	Constructs a MutableRevisionRecord based on the Content prepared by the DerivedPageDataUpdater. More...

Static Private Member Functions
static	toLegacyUser (UserIdentity $user)

Private Attributes
bool	$ajaxEditStash = true
	see $wgAjaxEditStash More...

IContentHandlerFactory	$contentHandlerFactory

DerivedPageDataUpdater	$derivedDataUpdater

EditResult null	$editResult = null

EditResultBuilder	$editResultBuilder

HookContainer	$hookContainer

HookRunner	$hookRunner

ILoadBalancer	$loadBalancer

Authority	$performer

int	$rcPatrolStatus = RecentChange::PRC_UNPATROLLED
	the RC patrol status the new revision should be marked with. More...

RevisionStore	$revisionStore

ServiceOptions	$serviceOptions

SlotRoleRegistry	$slotRoleRegistry

RevisionSlotsUpdate	$slotsUpdate

string[]	$softwareTags
	currently enabled software change tags More...

Status null	$status = null

array	$tags = []

bool	$useAutomaticEditSummaries = true
	see $wgUseAutomaticEditSummaries More...

bool	$usePageCreationLog = true
	whether to create a log entry for new page creations. More...

WikiPage	$wikiPage

Detailed Description

Controller-like object for creating and updating pages by creating new revisions.

PageUpdater instances provide compare-and-swap (CAS) protection against concurrent updates between the time grabParentRevision() is called and saveRevision() inserts a new revision. This allows application logic to safely perform edit conflict resolution using the parent revision's content.

See also: docs/pageupdater.md for more information.

MCR migration note: this replaces the relevant methods in WikiPage.

Since: 1.32

Definition at line 79 of file PageUpdater.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Storage\PageUpdater::__construct	(	Authority	$performer,
		WikiPage	$wikiPage,
		DerivedPageDataUpdater	$derivedDataUpdater,
		ILoadBalancer	$loadBalancer,
		RevisionStore	$revisionStore,
		SlotRoleRegistry	$slotRoleRegistry,
		IContentHandlerFactory	$contentHandlerFactory,
		HookContainer	$hookContainer,
		ServiceOptions	$serviceOptions,
		array	$softwareTags
	)

Parameters

Authority	$performer
WikiPage	$wikiPage
DerivedPageDataUpdater	$derivedDataUpdater
ILoadBalancer	$loadBalancer
RevisionStore	$revisionStore
SlotRoleRegistry	$slotRoleRegistry
IContentHandlerFactory	$contentHandlerFactory
HookContainer	$hookContainer
ServiceOptions	$serviceOptions
string[]	$softwareTags	Array of currently enabled software change tags. Can be obtained from ChangeTags::getSoftwareTags()

Definition at line 205 of file PageUpdater.php.

Member Function Documentation

◆ addTag()

MediaWiki\Storage\PageUpdater::addTag ( $tag )

Sets a tag to apply to this update.

Callers are responsible for permission checks, using ChangeTags::canAddTagsAccompanyingChange.

Parameters

string $tag

Definition at line 537 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\addTags().

◆ addTags()

MediaWiki\Storage\PageUpdater::addTags ( array $tags )

Sets tags to apply to this update.

Callers are responsible for permission checks, using ChangeTags::canAddTagsAccompanyingChange.

Parameters

string[] $tags

Definition at line 548 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$tags, and MediaWiki\Storage\PageUpdater\addTag().

◆ buildEditResult()

MediaWiki\Storage\PageUpdater::buildEditResult	(	RevisionRecord	$revision,
		bool	$isNew
	)

private

Builds the EditResult for this update.

Should be called by either doModify or doCreate.

Parameters

RevisionRecord	$revision
bool	$isNew

Definition at line 1082 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\doCreate(), MediaWiki\Storage\PageUpdater\doModify(), and MediaWiki\Storage\PageUpdater\doUpdate().

◆ checkAllRequiredRoles()

MediaWiki\Storage\PageUpdater::checkAllRequiredRoles	(	array	$roles,
		Status	$status
	)

private

Parameters

array	$roles
Status	$status

Definition at line 1657 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status, StatusValue\error(), and MediaWiki\Storage\PageUpdater\getRequiredSlotRoles().

Referenced by MediaWiki\Storage\PageUpdater\makeNewRevision().

◆ checkAllRolesAllowed()

MediaWiki\Storage\PageUpdater::checkAllRolesAllowed	(	array	$roles,
		Status	$status
	)

private

Parameters

array	$roles
Status	$status

Definition at line 1603 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status, StatusValue\error(), and MediaWiki\Storage\PageUpdater\getAllowedSlotRoles().

Referenced by MediaWiki\Storage\PageUpdater\saveRevision(), and MediaWiki\Storage\PageUpdater\updateRevision().

◆ checkAllRolesDerived()

MediaWiki\Storage\PageUpdater::checkAllRolesDerived	(	array	$roles,
		Status	$status
	)

private

Parameters

array	$roles
Status	$status

Definition at line 1620 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status, and StatusValue\error().

Referenced by MediaWiki\Storage\PageUpdater\updateRevision().

◆ checkFlags()

MediaWiki\Storage\PageUpdater::checkFlags ( $flags )

private

Check flags and add EDIT_NEW or EDIT_UPDATE to them as needed.

Parameters

int $flags

Returns: int Updated $flags

Definition at line 413 of file PageUpdater.php.

References EDIT_NEW, and EDIT_UPDATE.

Referenced by MediaWiki\Storage\PageUpdater\saveRevision().

◆ checkNoRolesRequired()

MediaWiki\Storage\PageUpdater::checkNoRolesRequired	(	array	$roles,
		Status	$status
	)

private

Parameters

array	$roles
Status	$status

Definition at line 1640 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status, StatusValue\error(), and MediaWiki\Storage\PageUpdater\getRequiredSlotRoles().

Referenced by MediaWiki\Storage\PageUpdater\saveRevision().

◆ computeEffectiveTags()

MediaWiki\Storage\PageUpdater::computeEffectiveTags ( $flags )

private

Parameters

int $flags Bit mask: a bit mask of EDIT_XXX flags.

Returns: string[]

Definition at line 568 of file PageUpdater.php.

References $content, MediaWiki\Storage\PageUpdater\$editResult, MediaWiki\Storage\PageUpdater\$tags, MediaWiki\Storage\PageUpdater\getContentHandler(), MediaWiki\Storage\PageUpdater\getEditResult(), MediaWiki\Storage\PageUpdater\getParentContent(), and MediaWiki\Storage\EditResult\getRevertTags().

Referenced by MediaWiki\Storage\PageUpdater\doCreate(), and MediaWiki\Storage\PageUpdater\doModify().

◆ doCreate()

MediaWiki\Storage\PageUpdater::doCreate	(	CommentStoreComment	$summary,
		UserIdentity	$user,
			$flags
	)

private

Parameters

CommentStoreComment	$summary	The edit summary
UserIdentity	$user	The revision's author
int	$flags	EDIT_XXX constants

Exceptions

DBUnexpectedError
MWException

Returns: Status

Definition at line 1341 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\saveRevision().

◆ doModify()

MediaWiki\Storage\PageUpdater::doModify	(	CommentStoreComment	$summary,
		UserIdentity	$user,
			$flags
	)

private

Parameters

CommentStoreComment	$summary	The edit summary
UserIdentity	$user	The revision's author
int	$flags	EDIT_XXX constants

Exceptions

MWException

Returns: Status

Definition at line 1158 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\saveRevision().

◆ doUpdate()

MediaWiki\Storage\PageUpdater::doUpdate	(	UserIdentity	$user,
		RevisionRecord	$revision
	)

private

Update derived slots in an existing revision.

If the revision is the current revision, this will update page_touched and trigger secondary updates.

We do not have sufficient information to know whether to or how to update recentchanges here, so, as opposed to doCreate(), updating recentchanges is left as the responsibility of the caller.

Parameters

UserIdentity	$user
RevisionRecord	$revision

Returns: Status

Definition at line 1100 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status, MediaWiki\Storage\PageUpdater\$wikiPage, DeferredUpdates\addUpdate(), MediaWiki\Storage\PageUpdater\buildEditResult(), DB_MASTER, EDIT_INTERNAL, MediaWiki\Storage\PageUpdater\getAtomicSectionUpdate(), Revision\RevisionRecord\getComment(), MediaWiki\Storage\PageUpdater\getDBConnectionRef(), Revision\RevisionRecord\getId(), MediaWiki\Storage\PageUpdater\getTitle(), MediaWiki\Storage\PageUpdater\getWikiId(), MediaWiki\Storage\PageUpdater\getWikiPage(), MediaWiki\Storage\PageUpdater\grabParentRevision(), StatusValue\newFatal(), StatusValue\newGood(), and Revision\MutableRevisionRecord\newUpdatedRevisionRecord().

Referenced by MediaWiki\Storage\PageUpdater\updateRevision().

◆ ensureRoleAllowed()

MediaWiki\Storage\PageUpdater::ensureRoleAllowed ( $role )

private

Definition at line 1585 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\getAllowedSlotRoles().

Referenced by MediaWiki\Storage\PageUpdater\setContent(), and MediaWiki\Storage\PageUpdater\setSlot().

◆ ensureRoleNotRequired()

MediaWiki\Storage\PageUpdater::ensureRoleNotRequired ( $role )

private

Definition at line 1592 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\getRequiredSlotRoles().

Referenced by MediaWiki\Storage\PageUpdater\removeSlot().

◆ getAllowedSlotRoles()

MediaWiki\Storage\PageUpdater::getAllowedSlotRoles ( )

private

Returns: string[] Slots allowed for this page update, as a list of role names.

Definition at line 1581 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\getTitle().

Referenced by MediaWiki\Storage\PageUpdater\checkAllRolesAllowed(), and MediaWiki\Storage\PageUpdater\ensureRoleAllowed().

◆ getAtomicSectionUpdate()

MediaWiki\Storage\PageUpdater::getAtomicSectionUpdate	(	IDatabase	$dbw,
		WikiPage	$wikiPage,
		RevisionRecord	$newRevisionRecord,
		UserIdentity	$user,
		CommentStoreComment	$summary,
			$flags,
		Status	$status,
			$hints = `[]`
	)

private

◆ getContentHandler()

MediaWiki\Storage\PageUpdater::getContentHandler ( $role )

private

Parameters

string $role slot role name

Returns: ContentHandler

Definition at line 612 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\grabParentRevision(), and Revision\RevisionRecord\RAW.

Referenced by MediaWiki\Storage\PageUpdater\computeEffectiveTags(), and MediaWiki\Storage\PageUpdater\makeAutoSummary().

◆ getDBConnectionRef()

MediaWiki\Storage\PageUpdater::getDBConnectionRef ( $mode )

private

Parameters

int $mode DB_MASTER or DB_REPLICA

Returns: DBConnRef

Definition at line 308 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\getWikiId().

Referenced by MediaWiki\Storage\PageUpdater\doCreate(), MediaWiki\Storage\PageUpdater\doModify(), and MediaWiki\Storage\PageUpdater\doUpdate().

◆ getEditResult()

MediaWiki\Storage\PageUpdater::getEditResult ( )

Returns the EditResult associated with this PageUpdater.

Will return null if PageUpdater::saveRevision() wasn't called yet. Will also return null if the update was not successful.

Returns: EditResult|null

Definition at line 527 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$editResult.

Referenced by MediaWiki\Storage\PageUpdater\computeEffectiveTags(), MediaWiki\Storage\PageUpdater\doModify(), and MediaWiki\Storage\PageUpdater\getAtomicSectionUpdate().

◆ getExplicitTags()

MediaWiki\Storage\PageUpdater::getExplicitTags ( )

Returns the list of tags set using the addTag() method.

Returns: string[]

Definition at line 560 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$tags.

◆ getLinkTarget()

MediaWiki\Storage\PageUpdater::getLinkTarget ( )

private

Returns: LinkTarget

Definition at line 315 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\saveRevision(), and MediaWiki\Storage\PageUpdater\updateRevision().

◆ getNewRevision()

MediaWiki\Storage\PageUpdater::getNewRevision ( )

The new revision created by saveRevision(), or null if saveRevision() has not yet been called, failed, or did not create a new revision because the content did not change.

Returns: RevisionRecord|null

Definition at line 984 of file PageUpdater.php.

◆ getParentContent()

MediaWiki\Storage\PageUpdater::getParentContent ( $role )

private

Returns the content of the given slot of the parent revision, with no audience checks applied.

If there is no parent revision or the slot is not defined, this returns null.

Parameters

string $role slot role name

Returns: Content|null

Definition at line 598 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\grabParentRevision(), and Revision\RevisionRecord\RAW.

Referenced by MediaWiki\Storage\PageUpdater\computeEffectiveTags(), and MediaWiki\Storage\PageUpdater\makeAutoSummary().

◆ getRequiredSlotRoles()

MediaWiki\Storage\PageUpdater::getRequiredSlotRoles ( )

private

Returns: string[] Slots required for this page update, as a list of role names.

Definition at line 1574 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\getTitle().

Referenced by MediaWiki\Storage\PageUpdater\checkAllRequiredRoles(), MediaWiki\Storage\PageUpdater\checkNoRolesRequired(), and MediaWiki\Storage\PageUpdater\ensureRoleNotRequired().

◆ getStatus()

MediaWiki\Storage\PageUpdater::getStatus ( )

The Status object indicating whether saveRevision() was successful, or null if saveRevision() was not yet called on this instance.

Note: This is here for compatibility with WikiPage::doEditContent. It may be deprecated soon.

Possible status errors: edit-hook-aborted: The ArticleSave hook aborted the update but didn't set the fatal flag of $status. edit-gone-missing: In update mode, but the article didn't exist. edit-conflict: In update mode, the article changed unexpectedly. edit-no-change: Warning that the text was the same as before. edit-already-exists: In creation mode, but the article already exists.

Extensions may define additional errors.

$return->value will contain an associative array with members as follows: new: Boolean indicating if the function attempted to create a new article. revision: The revision object for the inserted revision, or null.

Returns: null|Status

Definition at line 943 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status.

◆ getTitle()

MediaWiki\Storage\PageUpdater::getTitle ( )

private

Returns: Title

Definition at line 323 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\doCreate(), MediaWiki\Storage\PageUpdater\doModify(), MediaWiki\Storage\PageUpdater\doUpdate(), MediaWiki\Storage\PageUpdater\getAllowedSlotRoles(), MediaWiki\Storage\PageUpdater\getRequiredSlotRoles(), and MediaWiki\Storage\PageUpdater\makeNewRevision().

◆ getWikiId()

MediaWiki\Storage\PageUpdater::getWikiId ( )

private

Definition at line 299 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\doUpdate(), and MediaWiki\Storage\PageUpdater\getDBConnectionRef().

◆ getWikiPage()

MediaWiki\Storage\PageUpdater::getWikiPage ( )

private

Returns: WikiPage

Definition at line 331 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$wikiPage.

Referenced by MediaWiki\Storage\PageUpdater\doCreate(), MediaWiki\Storage\PageUpdater\doModify(), MediaWiki\Storage\PageUpdater\doUpdate(), MediaWiki\Storage\PageUpdater\makeNewRevision(), and MediaWiki\Storage\PageUpdater\saveRevision().

◆ grabParentRevision()

MediaWiki\Storage\PageUpdater::grabParentRevision ( )

Returns the revision that was the page's current revision when grabParentRevision() was first called.

This revision is the expected parent revision of the update, and will be recorded as the new revision's parent revision (unless no new revision is created because the content was not changed).

This method MUST not be called after saveRevision() was called!

The current revision determined by the first call to this method effectively acts a compare-and-swap (CAS) token which is checked by saveRevision(), which fails if any concurrent updates created a new revision.

Application code should call this method before applying transformations to the new content that depend on the parent revision, e.g. adding/replacing sections, or resolving conflicts via a 3-way merge. This protects against race conditions triggered by concurrent updates.

See also: DerivedPageDataUpdater::grabCurrentRevision()

Note: The expected parent revision is not to be confused with the logical base revision. The base revision is specified by the client, the parent revision is determined from the database. If base revision and parent revision are not the same, the updates is considered to require edit conflict resolution.

Exceptions

LogicException if called after saveRevision().

Returns: RevisionRecord|null the parent revision, or null of the page does not yet exist.

Definition at line 403 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\doModify(), MediaWiki\Storage\PageUpdater\doUpdate(), MediaWiki\Storage\PageUpdater\getContentHandler(), MediaWiki\Storage\PageUpdater\getParentContent(), MediaWiki\Storage\PageUpdater\hasEditConflict(), MediaWiki\Storage\PageUpdater\makeNewRevision(), MediaWiki\Storage\PageUpdater\saveRevision(), and MediaWiki\Storage\PageUpdater\updateRevision().

◆ hasEditConflict()

MediaWiki\Storage\PageUpdater::hasEditConflict ( $expectedParentRevision )

Checks whether this update conflicts with another update performed between the client loading data to prepare an edit, and the client committing the edit.

This is intended to detect user level "edit conflict" when the latest revision known to the client is no longer the current revision when processing the update.

An update expected to create a new page can be checked by setting $expectedParentRevision = 0. Such an update is considered to have a conflict if a current revision exists (that is, the page was created since the edit was initiated on the client).

This method returning true indicates to calling code that edit conflict resolution should be applied before saving any data. It does not prevent the update from being performed, and it should not be confused with a "late" conflict indicated by the "edit-conflict" status. A "late" conflict is a CAS failure caused by an update being performed concurrently between the time grabParentRevision() was called and the time saveRevision() trying to insert the new revision.

Note: A user level edit conflict is not the same as the "edit-conflict" status triggered by a CAS failure. Calling this method establishes the CAS token, it does not check against it: This method calls grabParentRevision(), and thus causes the expected parent revision for the update to be fixed to the page's current revision at this point in time. It acts as a compare-and-swap (CAS) token in that it is guaranteed that saveRevision() will fail with the "edit-conflict" status if the current revision of the page changes after hasEditConflict() (or grabParentRevision()) was called and before saveRevision() could insert a new revision.

See also: grabParentRevision()

Parameters

int $expectedParentRevision The ID of the revision the client expects to be the current one. Use 0 to indicate that the page is expected to not yet exist.

Returns: bool

Definition at line 369 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\grabParentRevision().

◆ inheritSlot()

MediaWiki\Storage\PageUpdater::inheritSlot ( SlotRecord $originalSlot )

Explicitly inherit a slot from some earlier revision.

The primary use case for this is rollbacks, when slots are to be inherited from the rollback target, overriding the content from the parent revision (which is the revision being rolled back).

This should typically not be used to inherit slots from the parent revision, which happens implicitly. Using this method causes the given slot to be treated as "modified" during revision creation, even if it has the same content as in the parent revision.

Parameters

SlotRecord $originalSlot A slot already existing in the database, to be inherited by the new revision.

Definition at line 458 of file PageUpdater.php.

References Revision\SlotRecord\newInherited().

◆ isNew()

MediaWiki\Storage\PageUpdater::isNew ( )

Whether saveRevision() was called and created a new page.

Returns: bool

Definition at line 961 of file PageUpdater.php.

◆ isUnchanged()

MediaWiki\Storage\PageUpdater::isUnchanged ( )

Whether saveRevision() did not create a revision because the content didn't change (null-edit).

Whether the content changed or not is determined by DerivedPageDataUpdater::isChange().

Returns: bool

Definition at line 972 of file PageUpdater.php.

◆ makeAutoSummary()

MediaWiki\Storage\PageUpdater::makeAutoSummary ( $flags )

private

Parameters

int $flags Bit mask: a bit mask of EDIT_XXX flags.

Returns: CommentStoreComment

Definition at line 633 of file PageUpdater.php.

References $content, EDIT_AUTOSUMMARY, MediaWiki\Storage\PageUpdater\getContentHandler(), MediaWiki\Storage\PageUpdater\getParentContent(), and CommentStoreComment\newUnsavedComment().

Referenced by MediaWiki\Storage\PageUpdater\saveRevision().

◆ makeNewRevision()

MediaWiki\Storage\PageUpdater::makeNewRevision	(	CommentStoreComment	$comment,
		UserIdentity	$user,
			$flags,
		Status	$status
	)

private

Constructs a MutableRevisionRecord based on the Content prepared by the DerivedPageDataUpdater.

This takes care of inheriting slots, updating slots with PST applied, and removing discontinued slots.

This calls Content::prepareSave() to verify that the slot content can be saved. The $status parameter is updated with any errors or warnings found by Content::prepareSave().

Parameters

CommentStoreComment	$comment
UserIdentity	$user
int	$flags
Status	$status

Returns: MutableRevisionRecord

Definition at line 1005 of file PageUpdater.php.

References $content, MediaWiki\Storage\PageUpdater\$status, $title, MediaWiki\Storage\PageUpdater\$wikiPage, MediaWiki\Storage\PageUpdater\checkAllRequiredRoles(), EDIT_MINOR, MediaWiki\Storage\PageUpdater\getTitle(), MediaWiki\Storage\PageUpdater\getWikiPage(), MediaWiki\Storage\PageUpdater\grabParentRevision(), StatusValue\merge(), MediaWiki\Storage\PageUpdater\toLegacyUser(), and wfWarn().

Referenced by MediaWiki\Storage\PageUpdater\doCreate(), and MediaWiki\Storage\PageUpdater\doModify().

◆ markAsRevert()

MediaWiki\Storage\PageUpdater::markAsRevert	(	int	$revertMethod,
		int	$oldestRevertedRevId,
		int	$newestRevertedRevId = `0`
	)

Marks this edit as a revert and applies relevant information.

Will also cause the PageUpdater to add a relevant change tag when saving the edit. Will do nothing if $oldestRevertedRevId is 0.

Parameters

int	$revertMethod	The method used to make the revert: REVERT_UNDO, REVERT_ROLLBACK or REVERT_MANUAL
int	$oldestRevertedRevId	The ID of the oldest revision that was reverted.
int	$newestRevertedRevId	The ID of the newest revision that was reverted. This parameter is optional, default value is $oldestRevertedRevId

See also: EditResultBuilder::markAsRevert()

Definition at line 510 of file PageUpdater.php.

◆ removeSlot()

MediaWiki\Storage\PageUpdater::removeSlot ( $role )

Removes the slot with the given role.

This discontinues the "stream" of slots with this role on the page, preventing the new revision, and any subsequent revisions, from inheriting the slot with this role.

Parameters

string $role A slot role name (but not "main")

Definition at line 476 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\ensureRoleNotRequired().

◆ saveRevision()

MediaWiki\Storage\PageUpdater::saveRevision	(	CommentStoreComment	$summary,
			$flags = `0`
	)

Change an existing article or create a new article.

Updates RC and all necessary caches, optionally via the deferred update array. This does not check user permissions.

It is guaranteed that saveRevision() will fail if the current revision of the page changes after grabParentRevision() was called and before saveRevision() can insert a new revision, as per the CAS mechanism described above.

The caller is however responsible for calling hasEditConflict() to detect a user-level edit conflict, and to adjust the content of the new revision accordingly, e.g. by using a 3-way-merge.

MCR migration note: this replaces WikiPage::doEditContent. Callers that change to using saveRevision() now need to check the "minoredit" themselves before using EDIT_MINOR.

Parameters

CommentStoreComment	$summary	Edit summary
int	$flags	Bitfield: EDIT_NEW Create a new page, or fail with "edit-already-exists" if the page exists. EDIT_UPDATE Create a new revision, or fail with "edit-gone-missing" if the page does not exist. EDIT_MINOR Mark this revision as minor EDIT_SUPPRESS_RC Do not log the change in recentchanges EDIT_FORCE_BOT Mark the revision as automated ("bot edit") EDIT_AUTOSUMMARY Fill in blank summaries with generated text where possible EDIT_INTERNAL Signal that the page retrieve/save cycle happened entirely in this request.

If neither EDIT_NEW nor EDIT_UPDATE is specified, the expected state is detected automatically via grabParentRevision(). In this case, the "edit-already-exists" or "edit-gone-missing" errors may still be triggered due to race conditions, if the page was unexpectedly created or deleted while revision creation is in progress. This can be viewed as part of the CAS mechanism described above.

Returns: RevisionRecord|null The new revision, or null if no new revision was created due to a failure or a null-edit. Use isUnchanged(), wasSuccessful() and getStatus() to determine the outcome of the revision creation.

Exceptions

MWException
RuntimeException

Definition at line 701 of file PageUpdater.php.

◆ setAjaxEditStash()

MediaWiki\Storage\PageUpdater::setAjaxEditStash ( $ajaxEditStash )

Parameters

bool $ajaxEditStash

See also: $wgAjaxEditStash

Definition at line 295 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$ajaxEditStash.

◆ setContent()

MediaWiki\Storage\PageUpdater::setContent	(		$role,
		Content	$content
	)

Set the new content for the given slot role.

Parameters

string	$role	A slot role name (such as "main")
Content	$content

Definition at line 427 of file PageUpdater.php.

References $content, and MediaWiki\Storage\PageUpdater\ensureRoleAllowed().

◆ setOriginalRevisionId()

MediaWiki\Storage\PageUpdater::setOriginalRevisionId ( $originalRevId )

Sets the ID of an earlier revision that is being repeated or restored by this update.

The new revision is expected to have the exact same content as the given original revision. This is used with rollbacks and with dummy "null" revisions which are created to record things like page moves.

This value is passed to the PageContentSaveComplete and NewRevisionFromEditComplete hooks.

Parameters

int | bool $originalRevId The original revision id, or false if no earlier revision is known to be repeated or restored by this update.

Definition at line 493 of file PageUpdater.php.

◆ setRcPatrolStatus()

MediaWiki\Storage\PageUpdater::setRcPatrolStatus ( $status )

Sets the "patrolled" status of the edit.

Callers should check the "patrol" and "autopatrol" permissions as appropriate.

See also: $wgUseRCPatrol; $wgUseNPPatrol

Parameters

int $status RC patrol status, e.g. RecentChange::PRC_AUTOPATROLLED.

Definition at line 276 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status.

◆ setSlot()

MediaWiki\Storage\PageUpdater::setSlot ( SlotRecord $slot )

Set the new slot for the given slot role.

Parameters

SlotRecord $slot

Definition at line 438 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\ensureRoleAllowed(), and Revision\SlotRecord\getRole().

◆ setUseAutomaticEditSummaries()

MediaWiki\Storage\PageUpdater::setUseAutomaticEditSummaries ( $useAutomaticEditSummaries )

Can be used to enable or disable automatic summaries that are applied to certain kinds of changes, like completely blanking a page.

Parameters

bool $useAutomaticEditSummaries

See also: $wgUseAutomaticEditSummaries

Definition at line 263 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$useAutomaticEditSummaries.

◆ setUsePageCreationLog()

MediaWiki\Storage\PageUpdater::setUsePageCreationLog ( $use )

Whether to create a log entry for new page creations.

See also: $wgPageCreationLog

Parameters

bool $use

Definition at line 287 of file PageUpdater.php.

◆ toLegacyUser()

static MediaWiki\Storage\PageUpdater::toLegacyUser ( UserIdentity $user )

staticprivate

Parameters

UserIdentity $user

Returns: User

Definition at line 252 of file PageUpdater.php.

References User\newFromIdentity().

Referenced by MediaWiki\Storage\PageUpdater\doCreate(), MediaWiki\Storage\PageUpdater\doModify(), MediaWiki\Storage\PageUpdater\getAtomicSectionUpdate(), MediaWiki\Storage\PageUpdater\makeNewRevision(), and MediaWiki\Storage\PageUpdater\saveRevision().

◆ updateRevision()

MediaWiki\Storage\PageUpdater::updateRevision ( int $revId = 0 )

Updates derived slots of an existing article.

Does not update RC. Updates all necessary caches, optionally via the deferred update array. This does not check user permissions. Does not do a PST.

Use isUnchanged(), wasSuccessful() and getStatus() to determine the outcome of the revision update.

Parameters

int $revId

Since: 1.36

Definition at line 847 of file PageUpdater.php.

References MediaWiki\Storage\PageUpdater\$status, MediaWiki\Storage\PageUpdater\checkAllRolesAllowed(), MediaWiki\Storage\PageUpdater\checkAllRolesDerived(), MediaWiki\Storage\PageUpdater\doUpdate(), StatusValue\fatal(), MediaWiki\Storage\PageUpdater\getLinkTarget(), ContentHandler\getLocalizedName(), MediaWiki\Storage\PageUpdater\grabParentRevision(), StatusValue\isOK(), StatusValue\newFatal(), StatusValue\newGood(), MediaWiki\Storage\PageUpdater\wasCommitted(), and wfMessage().

◆ wasCommitted()

MediaWiki\Storage\PageUpdater::wasCommitted ( )

Whether saveRevision() has been called on this instance.

Returns: bool

Definition at line 916 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\saveRevision(), and MediaWiki\Storage\PageUpdater\updateRevision().

◆ wasSuccessful()

MediaWiki\Storage\PageUpdater::wasSuccessful ( )

Whether saveRevision() completed successfully.

Returns: bool

Definition at line 952 of file PageUpdater.php.

Member Data Documentation

◆ $ajaxEditStash

bool MediaWiki\Storage\PageUpdater::$ajaxEditStash = true

private

see $wgAjaxEditStash

Definition at line 155 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\saveRevision(), and MediaWiki\Storage\PageUpdater\setAjaxEditStash().

◆ $contentHandlerFactory

IContentHandlerFactory MediaWiki\Storage\PageUpdater::$contentHandlerFactory

private

Definition at line 124 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $derivedDataUpdater

DerivedPageDataUpdater MediaWiki\Storage\PageUpdater::$derivedDataUpdater

private

Definition at line 104 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $editResult

EditResult null MediaWiki\Storage\PageUpdater::$editResult = null

private

Definition at line 180 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\computeEffectiveTags(), MediaWiki\Storage\PageUpdater\doModify(), MediaWiki\Storage\PageUpdater\getAtomicSectionUpdate(), and MediaWiki\Storage\PageUpdater\getEditResult().

◆ $editResultBuilder

EditResultBuilder MediaWiki\Storage\PageUpdater::$editResultBuilder

private

Definition at line 175 of file PageUpdater.php.

◆ $hookContainer

HookContainer MediaWiki\Storage\PageUpdater::$hookContainer

private

Definition at line 134 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $hookRunner

HookRunner MediaWiki\Storage\PageUpdater::$hookRunner

private

Definition at line 129 of file PageUpdater.php.

◆ $loadBalancer

ILoadBalancer MediaWiki\Storage\PageUpdater::$loadBalancer

private

Definition at line 109 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $performer

Authority MediaWiki\Storage\PageUpdater::$performer

private

Definition at line 94 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $rcPatrolStatus

int MediaWiki\Storage\PageUpdater::$rcPatrolStatus = RecentChange::PRC_UNPATROLLED

private

the RC patrol status the new revision should be marked with.

Definition at line 145 of file PageUpdater.php.

◆ $revisionStore

RevisionStore MediaWiki\Storage\PageUpdater::$revisionStore

private

Definition at line 114 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $serviceOptions

ServiceOptions MediaWiki\Storage\PageUpdater::$serviceOptions

private

Definition at line 190 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $slotRoleRegistry

SlotRoleRegistry MediaWiki\Storage\PageUpdater::$slotRoleRegistry

private

Definition at line 119 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $slotsUpdate

RevisionSlotsUpdate MediaWiki\Storage\PageUpdater::$slotsUpdate

private

Definition at line 165 of file PageUpdater.php.

◆ $softwareTags

string [] MediaWiki\Storage\PageUpdater::$softwareTags

private

currently enabled software change tags

Definition at line 185 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct().

◆ $status

Status null MediaWiki\Storage\PageUpdater::$status = null

private

Definition at line 170 of file PageUpdater.php.

◆ $tags

array MediaWiki\Storage\PageUpdater::$tags = []

private

Definition at line 160 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\addTags(), MediaWiki\Storage\PageUpdater\computeEffectiveTags(), MediaWiki\Storage\PageUpdater\doCreate(), MediaWiki\Storage\PageUpdater\doModify(), and MediaWiki\Storage\PageUpdater\getExplicitTags().

◆ $useAutomaticEditSummaries

bool MediaWiki\Storage\PageUpdater::$useAutomaticEditSummaries = true

private

see $wgUseAutomaticEditSummaries

See also: $wgUseAutomaticEditSummaries

Definition at line 140 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\setUseAutomaticEditSummaries().

◆ $usePageCreationLog

bool MediaWiki\Storage\PageUpdater::$usePageCreationLog = true

private

whether to create a log entry for new page creations.

Definition at line 150 of file PageUpdater.php.

◆ $wikiPage

WikiPage MediaWiki\Storage\PageUpdater::$wikiPage

private

Definition at line 99 of file PageUpdater.php.

Referenced by MediaWiki\Storage\PageUpdater\__construct(), MediaWiki\Storage\PageUpdater\doCreate(), MediaWiki\Storage\PageUpdater\doModify(), MediaWiki\Storage\PageUpdater\doUpdate(), MediaWiki\Storage\PageUpdater\getAtomicSectionUpdate(), MediaWiki\Storage\PageUpdater\getWikiPage(), and MediaWiki\Storage\PageUpdater\makeNewRevision().

◆ CONSTRUCTOR_OPTIONS

const MediaWiki\Storage\PageUpdater::CONSTRUCTOR_OPTIONS

Initial value:

= [
        'ManualRevertSearchRadius',
        'UseRCPatrol',
    ]

Options that have to be present in the ServiceOptions object passed to the constructor.

Access: internal

Definition at line 86 of file PageUpdater.php.

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

includes/Storage/PageUpdater.php

Public Member Functions

Public Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addTag()

◆ addTags()

◆ buildEditResult()

◆ checkAllRequiredRoles()

◆ checkAllRolesAllowed()

◆ checkAllRolesDerived()

◆ checkFlags()

◆ checkNoRolesRequired()

◆ computeEffectiveTags()

◆ doCreate()

◆ doModify()

◆ doUpdate()

◆ ensureRoleAllowed()

◆ ensureRoleNotRequired()

◆ getAllowedSlotRoles()

◆ getAtomicSectionUpdate()

◆ getContentHandler()

◆ getDBConnectionRef()

◆ getEditResult()

◆ getExplicitTags()

◆ getLinkTarget()

◆ getNewRevision()

◆ getParentContent()

◆ getRequiredSlotRoles()

◆ getStatus()

◆ getTitle()

◆ getWikiId()

◆ getWikiPage()

◆ grabParentRevision()

◆ hasEditConflict()

◆ inheritSlot()

◆ isNew()

◆ isUnchanged()

◆ makeAutoSummary()

◆ makeNewRevision()

◆ markAsRevert()

◆ removeSlot()

◆ saveRevision()

◆ setAjaxEditStash()

◆ setContent()

◆ setOriginalRevisionId()

◆ setRcPatrolStatus()

◆ setSlot()

◆ setUseAutomaticEditSummaries()

◆ setUsePageCreationLog()

◆ toLegacyUser()

◆ updateRevision()

◆ wasCommitted()

◆ wasSuccessful()

Member Data Documentation

◆ $ajaxEditStash

◆ $contentHandlerFactory

◆ $derivedDataUpdater

◆ $editResult

◆ $editResultBuilder

◆ $hookContainer

◆ $hookRunner

◆ $loadBalancer

◆ $performer

◆ $rcPatrolStatus

◆ $revisionStore

◆ $serviceOptions

◆ $slotRoleRegistry

◆ $slotsUpdate

◆ $softwareTags

◆ $status

◆ $tags

◆ $useAutomaticEditSummaries

◆ $usePageCreationLog

◆ $wikiPage

◆ CONSTRUCTOR_OPTIONS