Base representation for an editable wiki page. More...

Inherits Stringable, MediaWiki\Page\Page, and MediaWiki\Page\PageRecord.

Inherited by MediaWiki\Page\WikiCategoryPage, and MediaWiki\Page\WikiFilePage.

Collaboration diagram for MediaWiki\Page\WikiPage:

[legend]

Public Member Functions

__clone ()

Makes sure that the mTitle object is cloned to the newly cloned WikiPage.

__construct (PageIdentity $pageIdentity)

__toString ()

Returns an informative human readable unique representation of the page identity, for use as a cache key and for logging and debugging.

Returns: string

__wakeup ()

Ensure consistency when unserializing.

canExist ()

checkFlags ( $flags)

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

checkTouched ()

Loads page_touched and returns a value indicating if it should be used.

clear ()

Clear the object.

clearPreparedEdit ()

Clear the mPreparedEdit cache field, as may be needed by mutable content types.

doDeleteArticleReal ( $reason, UserIdentity $deleter, $suppress=false, $u1=null, &$error='', $u2=null, $tags=[], $logsubtype='delete', $immediate=false)

Back-end article deletion Deletes the article with database consistency, writes logs, purges caches.

doEditUpdates (RevisionRecord $revisionRecord, UserIdentity $user, array $options=[])

Do standard deferred updates after page edit.

doPurge ()

Perform the actions of a page purging.

doSecondaryDataUpdates (array $options=[])

Do secondary data updates (such as updating link tables).

doUpdateRestrictions (array $limit, array $expiry, &$cascade, $reason, UserIdentity $user, $tags=[])

Update the article's restriction field, and leave a log entry.

doUserEditContent (Content $content, Authority $performer, $summary, $flags=0, $originalRevId=false, $tags=[], $undidRevId=0)

Change an existing article or create a new article.

doViewUpdates (Authority $performer, $oldRev=null, $oldRevDeprecated=null)

Do standard deferred updates after page view (existing or missing page)

exists ()

followRedirect ()

Get the Title object or URL this page redirects to.

getActionOverrides ()

getAutoDeleteReason (&$hasHistory=false)

Auto-generates a deletion reason.

getCategories ()

Returns a list of categories this page is a member of.

getComment ( $audience=RevisionRecord::FOR_PUBLIC, ?Authority $performer=null)

getContent ( $audience=RevisionRecord::FOR_PUBLIC, ?Authority $performer=null)

Get the content of the latest revision.

getContentHandler ()

Returns the ContentHandler instance to be used to deal with the content of this WikiPage.

getContentModel ()

Returns the page's content model id (see the CONTENT_MODEL_XXX constants).

getContributors ()

Get a list of users who have edited this article, not including the user who made the most recent revision, which you can get from $article->getUser() if you want it.

getCreator ( $audience=RevisionRecord::FOR_PUBLIC, ?Authority $performer=null)

Get the User object of the user who created the page.

getCurrentUpdate ()

Get the state of an ongoing update, shortly before or just after it is saved to the database.

getDBkey ()

Get the page title in DB key form.This should always return a valid DB key.

Returns: string

getHiddenCategories ()

Returns a list of hidden categories this page is a member of.

getId ( $wikiId=self::LOCAL)

getLanguage ()

getLatest ( $wikiId=self::LOCAL)

Get the page_latest field.

getLinksTimestamp ()

Get the page_links_updated field.

getMinorEdit ()

Returns true if last revision was marked as "minor edit".

getNamespace ()

Returns the page's namespace number.The value returned by this method should represent a valid namespace, but this cannot be guaranteed in all cases.

Returns: int

getParserOutput (?ParserOptions $parserOptions=null, $oldid=null, $noCache=false, array $options=[], array &$errors=[])

Get a ParserOutput for the given ParserOptions and revision ID.

getRedirectTarget ()

If this page is a redirect, get its target.

getRedirectURL ( $rt)

Get the Title object or URL to use for a redirect.

getRevisionRecord ()

Get the latest revision.

getSourceURL ()

Get the source URL for the content on this page, typically the canonical URL, but may be a remote link if the content comes from another site.

getTimestamp ()

getTitle ()

Get the title object of the article.

getTouched ()

Get the page_touched field.

getUser ( $audience=RevisionRecord::FOR_PUBLIC, ?Authority $performer=null)

getUserText ( $audience=RevisionRecord::FOR_PUBLIC, ?Authority $performer=null)

getWikiDisplayName ()

The display name for the site this content come from.

getWikiId ()

hasViewableContent ()

Check if this page is something we're going to be showing some sort of sensible content for.

insertNullProtectionRevision (string $revCommentMsg, array $limit, array $expiry, bool $cascade, string $reason, UserIdentity $user)

Insert a new dummy revision (aka null revision) for this page, to mark a change in page protection.

insertOn ( $dbw, $pageId=null)

Insert a new empty page record for this article.

insertRedirectEntry (LinkTarget $rt, $oldLatest=null)

Insert or update the redirect table entry for this page to indicate it redirects to $rt.

isBatchedDelete ( $safetyMargin=0)

Determines if deletion of this page would be batched (executed over time by the job queue) or not (completed in the same request as the delete call).

isCountable ( $editInfo=false)

Whether the page may count towards the the site's number of "articles".

isLocal ()

Whether this content displayed on this page comes from the local database.

isNew ()

Tests if the page is new (only has one revision).

isRedirect ()

Is the page a redirect, according to secondary tracking tables? If this is true, getRedirectTarget() will return a Title.

isSamePageAs (PageReference $other)

Checks whether the given PageReference refers to the same page as this PageReference.Two PageReference instances are considered to refer to the same page if they belong to the same wiki, and have the same namespace and DB key.

Parameters

PageReference $other

Returns: bool

loadFromRow ( $data, $from)

Load the object from a database row.

loadPageData ( $from=IDBAccessObject::READ_NORMAL)

Load the object from a given source by title.

lockAndGetLatest ()

Lock the page row for this title+id and return page_latest (or 0)

makeParserOptions ( $context)

Get parser options suitable for rendering the primary article wikitext.

newPageUpdater ( $performer, ?RevisionSlotsUpdate $forUpdate=null)

Returns a PageUpdater for creating new revisions on this page (or creating the page).

pageDataFromId ( $dbr, $id, $options=[])

Fetch a page record matching the requested ID.

pageDataFromTitle ( $dbr, $title, $recency=IDBAccessObject::READ_NORMAL)

Fetch a page record matching the Title object's namespace and title using a sanitized title string.

prepareContentForEdit (Content $content, ?RevisionRecord $revision, UserIdentity $user, $serialFormat=null, $useStash=true)

Prepare content which is about to be saved.

protectDescription (array $limit, array $expiry)

Builds the description to serve as comment for the edit.

protectDescriptionLog (array $limit, array $expiry)

Builds the description to serve as comment for the log entry.

replaceSectionAtRev ( $sectionId, Content $sectionContent, $sectionTitle='', $baseRevId=null)

replaceSectionContent ( $sectionId, Content $sectionContent, $sectionTitle='', $edittime=null)

setTimestamp ( $ts)

Set the page timestamp (use only to avoid DB queries)

shouldCheckParserCache (ParserOptions $parserOptions, $oldId)

Should the parser cache be used?

supportsSections ()

Returns true if this page's content model supports sections.

toPageRecord ()

Returns the page represented by this WikiPage as a PageStoreRecord.

triggerOpportunisticLinksUpdate (ParserOutput $parserOutput)

Opportunistically enqueue link update jobs after a fresh parser output was generated.

updateParserCache (array $options=[])

Update the parser cache.

updateRevisionOn ( $dbw, RevisionRecord $revision, $lastRevision=null, $lastRevIsRedirect=null)

Update the page record to point to a newly saved revision.

wasLoadedFrom ( $from)

Checks whether the page data was loaded using the given database access mode (or better).

Public Member Functions inherited from MediaWiki\DAO\WikiAwareEntity

assertWiki ( $wikiId)

Throws if $wikiId is different from the return value of getWikiId().

Static Public Member Functions
static	convertSelectType ( $type)
	Convert deprecated 'fromdb', 'fromdbmaster' and 'forupdate' to READ_* constants.

static	getQueryInfo ()
	Return the tables, fields, and join conditions to be selected to create a new page object.

static	hasDifferencesOutsideMainSlot (RevisionRecord $a, RevisionRecord $b)
	Helper method for checking whether two revisions have differences that go beyond the main slot.

static	makeParserOptionsFromTitleAndModel (PageReference $pageRef, string $contentModel, $context)
	Create canonical parser options for a given title and content model.

static	onArticleCreate (Title $title, $maybeIsRedirect=true)
	The onArticle*() functions are supposed to be a kind of hooks which should be called whenever any of the specified actions are done.

static	onArticleDelete (Title $title)
	Clears caches when article is deleted.

static	onArticleEdit (Title $title, ?RevisionRecord $revRecord=null, $slotsChanged=null, $maybeRedirectChanged=true)
	Purge caches on page update etc.

Protected Member Functions
	clearCacheFields ()
	Clear the object cache fields.

	formatExpiry ( $expiry)

	loadLastEdit ()
	Loads everything except the text This isn't necessary for all uses, so it's only done if needed.

	pageData ( $dbr, $conditions, $options=[])
	Fetch a page record with the given conditions.

Protected Attributes
bool	$mDataLoaded = false

int	$mDataLoadedFrom = IDBAccessObject::READ_NONE
	One of the READ_* constants.

int null	$mId = null

string null	$mLanguage = null

int false	$mLatest = false
	False means "not loaded".

string	$mLinksUpdated = '19700101000000'

PreparedEdit false	$mPreparedEdit = false
	Map of cache fields (text, parser output, etc.) for a proposed/new edit.

string	$mTimestamp = ''
	Timestamp of the latest revision or empty string if not loaded.

Title	$mTitle

string	$mTouched = '19700101000000'

Additional Inherited Members
Public Attributes inherited from MediaWiki\DAO\WikiAwareEntity
const	LOCAL = false
	Wiki ID value to use with instances that are defined relative to the local wiki.

Detailed Description

Base representation for an editable wiki page.

Some fields are public only for backwards-compatibility. Use accessor methods. In the past, this class was part of Article.php and everything was public.

Definition at line 83 of file WikiPage.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Page\WikiPage::__construct ( PageIdentity $pageIdentity )

Definition at line 165 of file WikiPage.php.

References MediaWiki\DAO\WikiAwareEntity\assertWiki(), and MediaWiki\DAO\WikiAwareEntity\LOCAL.

Member Function Documentation

◆ __clone()

MediaWiki\Page\WikiPage::__clone ( )

Makes sure that the mTitle object is cloned to the newly cloned WikiPage.

Definition at line 181 of file WikiPage.php.

References MediaWiki\Page\WikiPage\$mTitle.

◆ __toString()

MediaWiki\Page\WikiPage::__toString ( )

Returns an informative human readable unique representation of the page identity, for use as a cache key and for logging and debugging.

Returns: string

Since: 1.36

Implements MediaWiki\Page\PageReference.

Definition at line 2971 of file WikiPage.php.

◆ __wakeup()

MediaWiki\Page\WikiPage::__wakeup ( )

Ensure consistency when unserializing.

Note: WikiPage objects should never be serialized in the first place. But some extensions like AbuseFilter did (see T213006), and we need to be able to read old data (see T187153).

Definition at line 2926 of file WikiPage.php.

◆ canExist()

MediaWiki\Page\WikiPage::canExist ( )

Returns: true

Since: 1.36

Implements MediaWiki\Page\ProperPageIdentity.

Definition at line 2963 of file WikiPage.php.

◆ checkFlags()

MediaWiki\Page\WikiPage::checkFlags ( $flags )

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

Deprecated: since 1.32, use exists() instead, or simply omit the EDIT_UPDATE and EDIT_NEW flags. To protect against race conditions, use PageUpdater::grabParentRevision.

Parameters

int $flags

Returns: int Updated $flags

Definition at line 1512 of file WikiPage.php.

References EDIT_NEW, and EDIT_UPDATE.

◆ checkTouched()

MediaWiki\Page\WikiPage::checkTouched ( )

Loads page_touched and returns a value indicating if it should be used.

Returns: bool True if this page exists and is not a redirect

Definition at line 653 of file WikiPage.php.

◆ clear()

MediaWiki\Page\WikiPage::clear ( )

Clear the object.

Returns: void

Definition at line 259 of file WikiPage.php.

◆ clearCacheFields()

MediaWiki\Page\WikiPage::clearCacheFields ( )

protected

Clear the object cache fields.

Returns: void

Definition at line 270 of file WikiPage.php.

◆ clearPreparedEdit()

MediaWiki\Page\WikiPage::clearPreparedEdit ( )

Clear the mPreparedEdit cache field, as may be needed by mutable content types.

Returns: void

Since: 1.23

Definition at line 291 of file WikiPage.php.

◆ convertSelectType()

static MediaWiki\Page\WikiPage::convertSelectType ( $type )

static

Convert deprecated 'fromdb', 'fromdbmaster' and 'forupdate' to READ_* constants.

Parameters

stdClass | string | int $type

Returns: mixed

Definition at line 191 of file WikiPage.php.

◆ doDeleteArticleReal()

MediaWiki\Page\WikiPage::doDeleteArticleReal	(		$reason,
		UserIdentity	$deleter,
			$suppress = false,
			$u1 = null,
		&	$error = '',
			$u2 = null,
			$tags = [],
			$logsubtype = 'delete',
			$immediate = false )

Back-end article deletion Deletes the article with database consistency, writes logs, purges caches.

Since: 1.19; 1.35 Signature changed, user moved to second parameter to prepare for requiring a user to be passed; 1.36 User second parameter is required

Deprecated: since 1.37 Use DeletePage instead. Calling ::deleteIfAllowed and letting DeletePage handle permission checks is preferred over doing permission checks yourself and then calling ::deleteUnsafe. Note that DeletePage returns a good status with false value in case of scheduled deletion, instead of a status with a warning. Also, the new method doesn't have an $error parameter, since any error is added to the returned Status.

Parameters

string	$reason	Delete reason for deletion log
UserIdentity	$deleter	The deleting user
bool	$suppress	Suppress all revisions and log the deletion in the suppression log instead of the deletion log
bool \| null	$u1	Unused
array \| string	&$error	Array of errors to append to
mixed	$u2	Unused
string[] \| null	$tags	Tags to apply to the deletion action
string	$logsubtype
bool	$immediate	false allows deleting over time via the job queue

Returns: Status<int> Status object; if successful, $status->value is the log_id of the deletion log entry. If the page couldn't be deleted because it wasn't found, $status is a non-fatal 'cannotdelete' error

Definition at line 2448 of file WikiPage.php.

References wfEscapeWikiText().

◆ doEditUpdates()

MediaWiki\Page\WikiPage::doEditUpdates	(	RevisionRecord	$revisionRecord,
		UserIdentity	$user,
		array	$options = [] )

Do standard deferred updates after page edit.

Update links tables, site stats, search index and message cache. Purges pages that include this page if the text was changed here. Every 100th edit, prune the recent changes table. Does not emit domain events.

Deprecated: since 1.32, use DerivedPageDataUpdater::doUpdates instead. Emitting warnings since 1.44

Parameters

RevisionRecord	$revisionRecord	(Switched from the old Revision class to RevisionRecord since 1.35)
UserIdentity	$user	User object that did the revision
array	$options	Array of options, see DerivedPageDataUpdater::prepareUpdate.

Definition at line 1865 of file WikiPage.php.

References MediaWiki\User\UserIdentity\getName(), and wfDeprecated().

◆ doPurge()

MediaWiki\Page\WikiPage::doPurge ( )

Perform the actions of a page purging.

Returns: bool

Note: In 1.28 (and only 1.28), this took a $flags parameter that controlled how much purging was done.

Reimplemented in MediaWiki\Page\WikiCategoryPage, and MediaWiki\Page\WikiFilePage.

Definition at line 1217 of file WikiPage.php.

References NS_MEDIAWIKI.

◆ doSecondaryDataUpdates()

MediaWiki\Page\WikiPage::doSecondaryDataUpdates ( array $options = [] )

Do secondary data updates (such as updating link tables).

Secondary data updates are only a small part of the updates needed after saving a new revision; normally PageUpdater::doUpdates should be used instead (which includes secondary data updates). This method is provided for partial purges.

Note: This does not update the parser cache. Use updateParserCache() for that.

Parameters

array

$options

recursive (bool, default true): whether to do a recursive update (update pages that depend on this page, e.g. transclude it). This will set the $recursive parameter of Content::getSecondaryDataUpdates. Typically this should be true unless the update was something that did not really change the page, such as a null edit.
triggeringUser: The user triggering the update (UserIdentity, defaults to the user who created the revision)
causeAction: an arbitrary string identifying the reason for the update. See DataUpdate::getCauseAction(). (default 'unknown')
causeAgent: name of the user who caused the update (string, default 'unknown')
defer: one of the DeferredUpdates constants, or false to run immediately (default: false). Note that even when this is set to false, some updates might still get deferred (as some update might directly add child updates to DeferredUpdates).
known-revision-output: a combined canonical ParserOutput for the revision, perhaps from some cache. The caller is responsible for ensuring that the ParserOutput indeed matched the $rev and $options. This mechanism is intended as a temporary stop-gap, for the time until caches have been changed to store RenderedRevision states instead of ParserOutput objects. (default: null) (since 1.33)

Since: 1.32

Definition at line 1940 of file WikiPage.php.

◆ doUpdateRestrictions()

MediaWiki\Page\WikiPage::doUpdateRestrictions	(	array	$limit,
		array	$expiry,
		&	$cascade,
			$reason,
		UserIdentity	$user,
			$tags = [] )

Update the article's restriction field, and leave a log entry.

This works for protection both existing and non-existing pages.

Parameters

array	$limit	Set of restriction keys
array	$expiry	Per restriction type expiration
bool	&$cascade	Set to false if cascading protection isn't allowed.
string	$reason
UserIdentity	$user	The user updating the restrictions
string[]	$tags	Change tags to add to the pages and protection log entries ($user should be able to add the specified tags before this is called)

Returns: Status<?int> Status object; if action is taken, $status->value is the log_id of the protection log entry.

Definition at line 1970 of file WikiPage.php.

References MediaWiki\User\UserIdentity\getId().

◆ doUserEditContent()

MediaWiki\Page\WikiPage::doUserEditContent	(	Content	$content,
		Authority	$performer,
			$summary,
			$flags = 0,
			$originalRevId = false,
			$tags = [],
			$undidRevId = 0 )

Change an existing article or create a new article.

Updates RC and all necessary caches, optionally via the deferred update array.

Parameters

Content	$content	New content
Authority	$performer	doing the edit
string \| CommentStoreComment	$summary	Edit summary
int	$flags	Bitfield, see the EDIT_XXX constants such as EDIT_NEW or EDIT_FORCE_BOT.

If neither EDIT_NEW nor EDIT_UPDATE is specified, the status of the article will be detected. If EDIT_UPDATE is specified and the article doesn't exist, the function will return an edit-gone-missing error. If EDIT_NEW is specified and the article does exist, an edit-already-exists error will be returned. These two conditions are also possible with auto-detection due to MediaWiki's performance-optimised locking strategy.

Parameters

int \| false	$originalRevId,	The ID of an original revision that the edit restores or repeats. 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. Default is false, meaning we are not making a rollback edit.
array \| null	$tags	Change tags to apply to this edit Callers are responsible for permission checks (with ChangeTags::canAddTagsAccompanyingChange)
int	$undidRevId	Id of revision that was undone or 0

Returns: PageUpdateStatus<array> Possible errors: edit-hook-aborted: The ArticleSave hook aborted the edit 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-record: The revision record object for the inserted revision, or null.

Deprecated: since 1.36, use PageUpdater::saveRevision instead. Note that the new method expects callers to take care of checking EDIT_MINOR against the minoredit right, and to apply the autopatrol right as appropriate.

Since: 1.36

Definition at line 1640 of file WikiPage.php.

◆ doViewUpdates()

MediaWiki\Page\WikiPage::doViewUpdates	(	Authority	$performer,
			$oldRev = null,
			$oldRevDeprecated = null )

Do standard deferred updates after page view (existing or missing page)

Parameters

Authority	$performer	The viewing user
RevisionRecord \| null \| int	$oldRev	The revision being viewed, or null if the latest revision is used. Passing integer for $oldid is deprecated since 1.46
RevisionRecord \| null	$oldRevDeprecated	Deprecated since 1.46

Definition at line 1166 of file WikiPage.php.

References wfDeprecatedMsg().

◆ exists()

MediaWiki\Page\WikiPage::exists ( )

Returns: bool Whether or not the page exists in the database

Implements MediaWiki\Page\PageIdentity.

Definition at line 553 of file WikiPage.php.

◆ followRedirect()

MediaWiki\Page\WikiPage::followRedirect ( )

Get the Title object or URL this page redirects to.

Returns: bool|Title|string False, Title of in-wiki target, or string with URL

Reimplemented in MediaWiki\Page\WikiFilePage.

Definition at line 999 of file WikiPage.php.

◆ formatExpiry()

MediaWiki\Page\WikiPage::formatExpiry ( $expiry )

protected

Parameters

string $expiry 14-char timestamp or "infinity", or false if the input was invalid

Returns: string

Definition at line 2317 of file WikiPage.php.

References wfMessage().

◆ getActionOverrides()

MediaWiki\Page\WikiPage::getActionOverrides ( )

Todo: Move this UI stuff somewhere else

See also: ContentHandler::getActionOverrides

Returns: array

Reimplemented in MediaWiki\Page\WikiFilePage.

Definition at line 229 of file WikiPage.php.

◆ getAutoDeleteReason()

MediaWiki\Page\WikiPage::getAutoDeleteReason ( & $hasHistory = false )

Auto-generates a deletion reason.

Parameters

bool &$hasHistory Whether the page has a history

Returns: string|false String containing deletion reason or empty string, or boolean false if no revision occurred

Definition at line 2789 of file WikiPage.php.

References wfDeprecated().

◆ getCategories()

MediaWiki\Page\WikiPage::getCategories ( )

Returns a list of categories this page is a member of.

Results will include hidden categories

Returns: TitleArrayFromResult

Definition at line 2714 of file WikiPage.php.

References NS_CATEGORY.

◆ getComment()

MediaWiki\Page\WikiPage::getComment	(		$audience = RevisionRecord::FOR_PUBLIC,
		?Authority	$performer = null )

Parameters

int	$audience	One of: RevisionRecord::FOR_PUBLIC to be displayed to all users RevisionRecord::FOR_THIS_USER to be displayed to the given user RevisionRecord::RAW get the text regardless of permissions
Authority \| null	$performer	object to check for, only if FOR_THIS_USER is passed to the $audience parameter (since 1.36, if using FOR_THIS_USER and not specifying a user no fallback is provided and the RevisionRecord method will throw an error)

Returns: string|null Comment stored for the last article revision, or null if the specified audience does not have access to the comment.

Definition at line 876 of file WikiPage.php.

◆ getContent()

MediaWiki\Page\WikiPage::getContent	(		$audience = RevisionRecord::FOR_PUBLIC,
		?Authority	$performer = null )

Get the content of the latest revision.

No side-effects...

Parameters

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

Returns: Content|null The content of the latest revision

Since: 1.21

Definition at line 776 of file WikiPage.php.

Referenced by MediaWiki\Content\TextContentHandler\getDataForSearchIndex().

◆ getContentHandler()

MediaWiki\Page\WikiPage::getContentHandler ( )

Returns the ContentHandler instance to be used to deal with the content of this WikiPage.

Shorthand for ContentHandlerFactory::getContentHandler( $this->getContentModel() );

Returns: ContentHandler

Since: 1.21

Definition at line 242 of file WikiPage.php.

References MediaWiki\MediaWikiServices\getInstance().

◆ getContentModel()

MediaWiki\Page\WikiPage::getContentModel ( )

Returns the page's content model id (see the CONTENT_MODEL_XXX constants).

Will use the revisions actual content model if the page exists, and the page's default if the page doesn't exist yet.

Returns: string

Since: 1.21

Definition at line 614 of file WikiPage.php.

◆ getContributors()

MediaWiki\Page\WikiPage::getContributors ( )

Get a list of users who have edited this article, not including the user who made the most recent revision, which you can get from $article->getUser() if you want it.

Returns: UserArray

Definition at line 1051 of file WikiPage.php.

◆ getCreator()

MediaWiki\Page\WikiPage::getCreator	(		$audience = RevisionRecord::FOR_PUBLIC,
		?Authority	$performer = null )

Get the User object of the user who created the page.

Parameters

int	$audience	One of: RevisionRecord::FOR_PUBLIC to be displayed to all users RevisionRecord::FOR_THIS_USER to be displayed to the given user RevisionRecord::RAW get the text regardless of permissions
Authority \| null	$performer	object to check for, only if FOR_THIS_USER is passed to the $audience parameter (since 1.36, if using FOR_THIS_USER and not specifying a user no fallback is provided and the RevisionRecord method will throw an error)

Returns: UserIdentity|null

Definition at line 836 of file WikiPage.php.

References MediaWiki\Revision\RevisionRecord\getUser().

◆ getCurrentUpdate()

MediaWiki\Page\WikiPage::getCurrentUpdate ( )

Get the state of an ongoing update, shortly before or just after it is saved to the database.

If there is no ongoing edit tracked by this WikiPage instance, this methods throws a PreconditionException.

If possible, state is shared with subsequent calls of getPreparedUpdate(), prepareContentForEdit(), and newPageUpdater().

Note: This method should generally be avoided, since it forces WikiPage to maintain state representing ongoing edits. Code that initiates an edit should use newPageUpdater() instead. Hooks that interact with the edit should have a the relevant information provided as a PageUpdater, PreparedUpdate, or RenderedRevision.

Exceptions

PreconditionException if there is no ongoing update. This method must only be called after newPageUpdater() had already been called, typically while executing a handler for a hook that is triggered during a page edit.

Returns: PreparedUpdate

Since: 1.38

Definition at line 2255 of file WikiPage.php.

◆ getDBkey()

MediaWiki\Page\WikiPage::getDBkey ( )

Get the page title in DB key form.This should always return a valid DB key.

Returns: string

Since: 1.36

Implements MediaWiki\Page\ProperPageIdentity.

Definition at line 2947 of file WikiPage.php.

◆ getHiddenCategories()

MediaWiki\Page\WikiPage::getHiddenCategories ( )

Returns a list of hidden categories this page is a member of.

Uses the page_props and categorylinks tables.

Returns: Title[]

Definition at line 2739 of file WikiPage.php.

References NS_CATEGORY.

◆ getId()

MediaWiki\Page\WikiPage::getId ( $wikiId = self::LOCAL )

Parameters

string | false $wikiId

Returns: int Page ID

Implements MediaWiki\Page\ProperPageIdentity.

Definition at line 541 of file WikiPage.php.

Referenced by MediaWiki\Content\ContentHandler\getDataForSearchIndex().

◆ getLanguage()

MediaWiki\Page\WikiPage::getLanguage ( )

Returns: ?string language code for the page

Implements MediaWiki\Page\PageRecord.

Definition at line 671 of file WikiPage.php.

◆ getLatest()

MediaWiki\Page\WikiPage::getLatest ( $wikiId = self::LOCAL )

Get the page_latest field.

Parameters

string | false $wikiId

Returns: int The rev_id of latest revision

Implements MediaWiki\Page\PageRecord.

Definition at line 695 of file WikiPage.php.

◆ getLinksTimestamp()

MediaWiki\Page\WikiPage::getLinksTimestamp ( )

Get the page_links_updated field.

Returns: string|null Timestamp in TS::MW format

Definition at line 683 of file WikiPage.php.

◆ getMinorEdit()

MediaWiki\Page\WikiPage::getMinorEdit ( )

Returns true if last revision was marked as "minor edit".

Returns: bool Minor edit indicator for the last article revision.

Definition at line 891 of file WikiPage.php.

◆ getNamespace()

MediaWiki\Page\WikiPage::getNamespace ( )

Returns the page's namespace number.The value returned by this method should represent a valid namespace, but this cannot be guaranteed in all cases.

Returns: int

Since: 1.36

Implements MediaWiki\Page\PageReference.

Definition at line 2939 of file WikiPage.php.

◆ getParserOutput()

MediaWiki\Page\WikiPage::getParserOutput	(	?ParserOptions	$parserOptions = null,
			$oldid = null,
			$noCache = false,
		array	$options = [],
		array &	$errors = [] )

Get a ParserOutput for the given ParserOptions and revision ID.

The parser cache will be used if possible. Cache misses that result in parser runs are debounced with PoolCounter.

XXX merge this with updateParserCache()?

Since: 1.19

Parameters

ParserOptions \| null	$parserOptions	ParserOptions to use for the parse operation
null \| int \| RevisionRecord	$oldid	Revision or Revision ID to get the text from, passing null or 0 will get the latest revision (default value)
bool	$noCache	Do not read from or write to caches.
array	$options	Extra ParserOutputAccess options; see ParserOutputAccess::getParserOutput()
MessageSpecifier[]	&$errors	Errors returned by ParserOutputAccess on a failure (false return value).

Returns: ParserOutput|false ParserOutput or false if the revision was not found or is not public

Definition at line 1123 of file WikiPage.php.

◆ getQueryInfo()

static MediaWiki\Page\WikiPage::getQueryInfo ( )

static

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

Since: 1.31

Returns

array[] With three keys:

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

Definition at line 308 of file WikiPage.php.

◆ getRedirectTarget()

MediaWiki\Page\WikiPage::getRedirectTarget ( )

If this page is a redirect, get its target.

The target will be fetched from the redirect table if possible.

Deprecated: since 1.38 Use RedirectLookup::getRedirectTarget() instead.

Returns: Title|null Title object, or null if this page is not a redirect

Definition at line 977 of file WikiPage.php.

◆ getRedirectURL()

MediaWiki\Page\WikiPage::getRedirectURL ( $rt )

Get the Title object or URL to use for a redirect.

We use Title objects for same-wiki, non-special redirects and URLs for everything else.

Parameters

Title $rt Redirect target

Returns: Title|string|false False, Title object of local target, or string with URL

Definition at line 1010 of file WikiPage.php.

References $source.

◆ getRevisionRecord()

MediaWiki\Page\WikiPage::getRevisionRecord ( )

Get the latest revision.

Since: 1.32

Returns: RevisionRecord|null

Definition at line 758 of file WikiPage.php.

Referenced by MediaWiki\Content\ContentHandler\getDataForSearchIndex(), and MediaWiki\Content\ContentHandler\latestRevision().

◆ getSourceURL()

MediaWiki\Page\WikiPage::getSourceURL ( )

Get the source URL for the content on this page, typically the canonical URL, but may be a remote link if the content comes from another site.

Since: 1.28

Returns: string

Reimplemented in MediaWiki\Page\WikiFilePage.

Definition at line 2916 of file WikiPage.php.

◆ getTimestamp()

MediaWiki\Page\WikiPage::getTimestamp ( )

Returns: string MW timestamp of last article revision

Definition at line 787 of file WikiPage.php.

◆ getTitle()

MediaWiki\Page\WikiPage::getTitle ( )

Get the title object of the article.

Returns: Title Title object of this page

Definition at line 251 of file WikiPage.php.

Referenced by MediaWiki\Content\TextContentHandler\getDataForSearchIndex(), MediaWiki\Content\FileContentHandler\getDataForSearchIndex(), MediaWiki\Content\WikitextContentHandler\getDataForSearchIndex(), MediaWiki\Page\WikiCategoryPage\isExpectedUnusedCategory(), MediaWiki\Page\WikiCategoryPage\isHidden(), MediaWiki\Content\ContentHandler\latestRevision(), MediaWiki\Page\Article\newFromWikiPage(), MediaWiki\RecentChanges\CategoryMembershipChangeJob\notifyUpdatesForRevision(), MediaWiki\Context\DerivativeContext\setWikiPage(), and MediaWiki\Context\RequestContext\setWikiPage().

◆ getTouched()

MediaWiki\Page\WikiPage::getTouched ( )

Get the page_touched field.

Returns: string Timestamp in TS::MW format

Implements MediaWiki\Page\PageRecord.

Definition at line 661 of file WikiPage.php.

◆ getUser()

MediaWiki\Page\WikiPage::getUser	(		$audience = RevisionRecord::FOR_PUBLIC,
		?Authority	$performer = null )

Parameters

int	$audience	One of: RevisionRecord::FOR_PUBLIC to be displayed to all users RevisionRecord::FOR_THIS_USER to be displayed to the given user RevisionRecord::RAW get the text regardless of permissions
Authority \| null	$performer	object to check for, only if FOR_THIS_USER is passed to the $audience parameter (since 1.36, if using FOR_THIS_USER and not specifying a user no fallback is provided and the RevisionRecord method will throw an error)

Returns: int User ID for the user that made the last article revision

Definition at line 815 of file WikiPage.php.

◆ getUserText()

MediaWiki\Page\WikiPage::getUserText	(		$audience = RevisionRecord::FOR_PUBLIC,
		?Authority	$performer = null )

Parameters

int	$audience	One of: RevisionRecord::FOR_PUBLIC to be displayed to all users RevisionRecord::FOR_THIS_USER to be displayed to the given user RevisionRecord::RAW get the text regardless of permissions
Authority \| null	$performer	object to check for, only if FOR_THIS_USER is passed to the $audience parameter (since 1.36, if using FOR_THIS_USER and not specifying a user no fallback is provided and the RevisionRecord method will throw an error)

Returns: string Username of the user that made the last article revision

Definition at line 855 of file WikiPage.php.

◆ getWikiDisplayName()

MediaWiki\Page\WikiPage::getWikiDisplayName ( )

The display name for the site this content come from.

If a subclass overrides isLocal(), this could return something other than the current site name

Since: 1.28

Returns: string

Reimplemented in MediaWiki\Page\WikiFilePage.

Definition at line 2902 of file WikiPage.php.

◆ getWikiId()

MediaWiki\Page\WikiPage::getWikiId ( )

Returns: false self::LOCAL

Since: 1.36

Implements MediaWiki\Page\ProperPageIdentity.

Definition at line 2955 of file WikiPage.php.

◆ hasDifferencesOutsideMainSlot()

static MediaWiki\Page\WikiPage::hasDifferencesOutsideMainSlot	(	RevisionRecord	$a,
		RevisionRecord	$b )

static

Helper method for checking whether two revisions have differences that go beyond the main slot.

MCR migration note: this method should go away!

Deprecated: since 1.43; Use only as a stop-gap before refactoring to support MCR.

Parameters

RevisionRecord	$a
RevisionRecord	$b

Returns: bool

Definition at line 1393 of file WikiPage.php.

References MediaWiki\Revision\RevisionRecord\getSlots().

◆ hasViewableContent()

MediaWiki\Page\WikiPage::hasViewableContent ( )

Check if this page is something we're going to be showing some sort of sensible content for.

If we return false, page views (plain action=view) will return an HTTP 404 response, so spiders and robots can know they're following a bad link.

Returns: bool

Reimplemented in MediaWiki\Page\WikiCategoryPage.

Definition at line 568 of file WikiPage.php.

◆ insertNullProtectionRevision()

MediaWiki\Page\WikiPage::insertNullProtectionRevision	(	string	$revCommentMsg,
		array	$limit,
		array	$expiry,
		bool	$cascade,
		string	$reason,
		UserIdentity	$user )

Insert a new dummy revision (aka null revision) for this page, to mark a change in page protection.

Since: 1.35

Parameters

string	$revCommentMsg	Comment message key for the revision
array	$limit	Set of restriction keys
array	$expiry	Per restriction type expiration
bool	$cascade	Set to false if cascading protection isn't allowed.
string	$reason
UserIdentity	$user	User to attribute to

Returns: RevisionRecord|null Null on error

Definition at line 2278 of file WikiPage.php.

References wfMessage().

◆ insertOn()

MediaWiki\Page\WikiPage::insertOn	(		$dbw,
			$pageId = null )

Insert a new empty page record for this article.

This must be followed up by creating a revision and running $this->updateRevisionOn( ... ); or else the record will be left in a funky state. Best if all done inside a transaction.

Access: internal: Low level interface, not safe for use in extensions!

Todo: Factor out into a PageStore service, to be used by PageUpdater.

Parameters

IDatabase	$dbw
int \| null	$pageId	Custom page ID that will be used for the insert statement

Returns: int|false The newly created page_id key; false if the row was not inserted, e.g. because the title already existed or because the specified page ID is already in use.

Definition at line 1255 of file WikiPage.php.

References wfRandom().

◆ insertRedirectEntry()

MediaWiki\Page\WikiPage::insertRedirectEntry	(	LinkTarget	$rt,
			$oldLatest = null )

Insert or update the redirect table entry for this page to indicate it redirects to $rt.

Deprecated: since 1.43; use RedirectStore::updateRedirectTarget() instead.

Parameters

LinkTarget	$rt	Redirect target
int \| null	$oldLatest	Prior page_latest for check and set

Returns: bool Success

Definition at line 989 of file WikiPage.php.

◆ isBatchedDelete()

MediaWiki\Page\WikiPage::isBatchedDelete ( $safetyMargin = 0 )

Determines if deletion of this page would be batched (executed over time by the job queue) or not (completed in the same request as the delete call).

It is unlikely but possible that an edit from another request could push the page over the batching threshold after this function is called, but before the caller acts upon the return value. Callers must decide for themselves how to deal with this. $safetyMargin is provided as an unreliable but situationally useful help for some common cases.

Deprecated: since 1.37 Use DeletePage::isBatchedDelete instead.

Parameters

int $safetyMargin Added to the revision count when checking for batching

Returns: bool True if deletion would be batched, false otherwise

Definition at line 2409 of file WikiPage.php.

◆ isCountable()

MediaWiki\Page\WikiPage::isCountable ( $editInfo = false )

Whether the page may count towards the the site's number of "articles".

This is tracked in the site_stats table, and calculated based on the namespace, page metadata, and content.

See also: $wgArticleCountMethod; SlotRoleHandler::supportsArticleCount; Content::isCountable; WikitextContent::isCountable

Parameters

PreparedEdit | PreparedUpdate | false $editInfo (false): An object returned by prepareTextForEdit() or getCurrentUpdate() respectively; If false is given, the current database state will be used.

Returns: bool

Definition at line 916 of file WikiPage.php.

◆ isLocal()

MediaWiki\Page\WikiPage::isLocal ( )

Whether this content displayed on this page comes from the local database.

Since: 1.28

Returns: bool

Reimplemented in MediaWiki\Page\WikiFilePage.

Definition at line 2889 of file WikiPage.php.

◆ isNew()

MediaWiki\Page\WikiPage::isNew ( )

Tests if the page is new (only has one revision).

May produce false negatives for some old pages.

Since: 1.36

Returns: bool

Implements MediaWiki\Page\PageRecord.

Definition at line 596 of file WikiPage.php.

◆ isRedirect()

MediaWiki\Page\WikiPage::isRedirect ( )

Is the page a redirect, according to secondary tracking tables? If this is true, getRedirectTarget() will return a Title.

Returns: bool

Implements MediaWiki\Page\PageRecord.

Reimplemented in MediaWiki\Page\WikiFilePage.

Definition at line 578 of file WikiPage.php.

◆ isSamePageAs()

MediaWiki\Page\WikiPage::isSamePageAs ( PageReference $other )

Checks whether the given PageReference refers to the same page as this PageReference.Two PageReference instances are considered to refer to the same page if they belong to the same wiki, and have the same namespace and DB key.

Parameters

PageReference $other

Returns: bool

Since: 1.36

Implements MediaWiki\Page\PageReference.

Definition at line 2979 of file WikiPage.php.

◆ loadFromRow()

MediaWiki\Page\WikiPage::loadFromRow	(		$data,
			$from )

Load the object from a database row.

Parameters

stdClass \| false	$data	DB row containing fields returned by getQueryInfo() or false
string \| int	$from	One of the following: IDBAccessObject::READ_NORMAL if the data was from a replica DB IDBAccessObject::READ_LATEST if the data was from the primary DB IDBAccessObject::READ_LOCKING if the data was from the primary DB using SELECT FOR UPDATE "fromdb", alias for IDBAccessObject::READ_NORMAL (deprecated Since 1.46) "fromdbmaster", alias for IDBAccessObject::READ_LATEST (deprecated Since 1.46) "forupdate", alias for IDBAccessObject::READ_LOCKING (deprecated Since 1.46)

Since: 1.20

Definition at line 490 of file WikiPage.php.

◆ loadLastEdit()

MediaWiki\Page\WikiPage::loadLastEdit ( )

protected

Loads everything except the text This isn't necessary for all uses, so it's only done if needed.

Definition at line 708 of file WikiPage.php.

◆ loadPageData()

MediaWiki\Page\WikiPage::loadPageData ( $from = IDBAccessObject::READ_NORMAL )

Load the object from a given source by title.

Parameters

stdClass | string | int

$from

One of the following:

A DB query result object.
IDBAccessObject::READ_NORMAL to get from a replica DB.
IDBAccessObject::READ_LATEST to get from the primary DB.
IDBAccessObject::READ_LOCKING to get from the primary DB using SELECT FOR UPDATE.
"fromdb", alias for IDBAccessObject::READ_NORMAL (deprecated Since 1.46)
"fromdbmaster", alias for IDBAccessObject::READ_LATEST (deprecated Since 1.46)
"forupdate", alias for IDBAccessObject::READ_LOCKING (deprecated Since 1.46)

Returns: void

Definition at line 413 of file WikiPage.php.

References DB_PRIMARY, and DB_REPLICA.

Referenced by MediaWiki\Content\ContentHandler\latestRevision().

◆ lockAndGetLatest()

MediaWiki\Page\WikiPage::lockAndGetLatest ( )

Lock the page row for this title+id and return page_latest (or 0)

Returns: int Returns 0 if no row was found with this title+id

Since: 1.27

Definition at line 2484 of file WikiPage.php.

◆ makeParserOptions()

MediaWiki\Page\WikiPage::makeParserOptions ( $context )

Get parser options suitable for rendering the primary article wikitext.

See also: ParserOptions::newCanonical

Parameters

IContextSource | UserIdentity | string

$context

One of the following:

IContextSource: Use the User and the Language of the provided context
UserIdentity: Use the provided UserIdentity object and $wgLang for the language, so use an IContextSource object if possible.
'canonical': Canonical options (anonymous user with default preferences and content language).

Returns: ParserOptions

Definition at line 1760 of file WikiPage.php.

Referenced by MediaWiki\Content\ContentHandler\getParserOutputForIndexing().

◆ makeParserOptionsFromTitleAndModel()

static MediaWiki\Page\WikiPage::makeParserOptionsFromTitleAndModel	(	PageReference	$pageRef,
		string	$contentModel,
			$context )

static

Create canonical parser options for a given title and content model.

Access: internal

Parameters

PageReference	$pageRef
string	$contentModel
IContextSource \| UserIdentity \| string	$context	See ::makeParserOptions

Returns: ParserOptions

Definition at line 1774 of file WikiPage.php.

◆ newPageUpdater()

MediaWiki\Page\WikiPage::newPageUpdater	(		$performer,
		?RevisionSlotsUpdate	$forUpdate = null )

Returns a PageUpdater for creating new revisions on this page (or creating the page).

The PageUpdater can also be used to detect the need for edit conflict resolution, and to protected such conflict resolution from concurrent edits using a check-and-set mechanism.

Since: 1.32

Note: Once extensions no longer rely on WikiPage to get access to the state of an ongoing edit via prepareContentForEdit() and WikiPage::getCurrentUpdate(), this method should be deprecated and callers should be migrated to using PageUpdaterFactory::newPageUpdater() instead.

Parameters

Authority \| UserIdentity	$performer
RevisionSlotsUpdate \| null	$forUpdate	If given, allows any cached ParserOutput that may already have been returned via getDerivedDataUpdater to be re-used.

Returns: PageUpdater

Definition at line 1731 of file WikiPage.php.

References MediaWiki\Permissions\Authority\getUser().

◆ onArticleCreate()

static MediaWiki\Page\WikiPage::onArticleCreate	(	Title	$title,
			$maybeIsRedirect = true )

static

The onArticle*() functions are supposed to be a kind of hooks which should be called whenever any of the specified actions are done.

This is a good place to put code to clear caches, for instance.

This is called on page move and undelete, as well as edit

Parameters

Title	$title
bool	$maybeIsRedirect	True if the page may have been created as a redirect. If false, this is used as a hint to skip some unnecessary updates.

Definition at line 2513 of file WikiPage.php.

References MediaWiki\Title\Title\getNamespace(), MediaWiki\Title\Title\getOtherPage(), NS_CATEGORY, and MediaWiki\Title\Title\touchLinks().

◆ onArticleDelete()

static MediaWiki\Page\WikiPage::onArticleDelete ( Title $title )

static

Clears caches when article is deleted.

Access: internal: for use by DeletePage and MovePage.

Todo: pull this into DeletePage

Parameters

Title $title

Definition at line 2551 of file WikiPage.php.

References MediaWiki\Title\Title\getNamespace(), MediaWiki\Title\Title\getOtherPage(), MediaWiki\Title\Title\getText(), NS_USER_TALK, and MediaWiki\Title\Title\touchLinks().

◆ onArticleEdit()

static MediaWiki\Page\WikiPage::onArticleEdit	(	Title	$title,
		?RevisionRecord	$revRecord = null,
			$slotsChanged = null,
			$maybeRedirectChanged = true )

static

Purge caches on page update etc.

Parameters

Title	$title
RevisionRecord \| null	$revRecord	revision that was just saved, may be null
string[] \| null	$slotsChanged	The role names of the slots that were changed. If not given, all slots are assumed to have changed.
bool	$maybeRedirectChanged	True if the page's redirect target may have changed in the latest revision. If false, this is used as a hint to skip some unnecessary updates.

Definition at line 2604 of file WikiPage.php.

References MediaWiki\Revision\RevisionRecord\getId().

◆ pageData()

MediaWiki\Page\WikiPage::pageData	(	$dbr,
		$conditions,
		$options = [] )

protected

Fetch a page record with the given conditions.

Parameters

IReadableDatabase	$dbr
array	$conditions
array	$options

Returns: stdClass|false Database result resource, or false on failure

Definition at line 344 of file WikiPage.php.

◆ pageDataFromId()

MediaWiki\Page\WikiPage::pageDataFromId	(	$dbr,
		$id,
		$options = [] )

Fetch a page record matching the requested ID.

Parameters

IReadableDatabase	$dbr
int	$id
array	$options

Returns: stdClass|false Database result resource, or false on failure

Definition at line 395 of file WikiPage.php.

◆ pageDataFromTitle()

MediaWiki\Page\WikiPage::pageDataFromTitle	(	$dbr,
		$title,
		$recency = IDBAccessObject::READ_NORMAL )

Fetch a page record matching the Title object's namespace and title using a sanitized title string.

Parameters

IReadableDatabase	$dbr
Title	$title
int	$recency

Returns: stdClass|false Database result resource, or false on failure

Definition at line 371 of file WikiPage.php.

◆ prepareContentForEdit()

MediaWiki\Page\WikiPage::prepareContentForEdit	(	Content	$content,
		?RevisionRecord	$revision,
		UserIdentity	$user,
			$serialFormat = null,
			$useStash = true )

Prepare content which is about to be saved.

Prior to 1.30, this returned a stdClass.

Deprecated: since 1.32, use newPageUpdater() or getCurrentUpdate() instead.

Note: Calling without a UserIdentity was separately deprecated from 1.37 to 1.39, since 1.39 the UserIdentity has been required.

Parameters

Content	$content
RevisionRecord \| null	$revision	Used with vary-revision or vary-revision-id.
UserIdentity	$user
string \| null	$serialFormat	IGNORED
bool	$useStash	Use prepared edit stash

Returns: PreparedEdit

Since: 1.21

Definition at line 1823 of file WikiPage.php.

References MediaWiki\User\UserIdentity\getName().

◆ protectDescription()

MediaWiki\Page\WikiPage::protectDescription	(	array	$limit,
		array	$expiry )

Builds the description to serve as comment for the edit.

Parameters

array	$limit	Set of restriction keys
array	$expiry	Per restriction type expiration

Returns: string

Definition at line 2339 of file WikiPage.php.

References wfMessage().

◆ protectDescriptionLog()

MediaWiki\Page\WikiPage::protectDescriptionLog	(	array	$limit,
		array	$expiry )

Builds the description to serve as comment for the log entry.

Some bots may parse IRC lines, which are generated from log entries which contain plain protect description text. Keep them in old format to avoid breaking compatibility. TODO: Fix protection log to store structured description and format it on-the-fly.

Parameters

array	$limit	Set of restriction keys
array	$expiry	Per restriction type expiration

Returns: string

Definition at line 2381 of file WikiPage.php.

◆ replaceSectionAtRev()

MediaWiki\Page\WikiPage::replaceSectionAtRev	(		$sectionId,
		Content	$sectionContent,
			$sectionTitle = '',
			$baseRevId = null )

Parameters

string \| int \| null \| false	$sectionId	Section identifier as a number or string (e.g. 0, 1 or 'T-1'), null/false or an empty string for the whole page or 'new' for a new section.
Content	$sectionContent	New content of the section.
string	$sectionTitle	New section's subject, only if $section is "new".
int \| null	$baseRevId

Returns: Content|null New complete article content, or null if error.

Since: 1.24

Definition at line 1466 of file WikiPage.php.

References MediaWiki\Revision\RevisionRecord\getContent(), and wfDebug().

◆ replaceSectionContent()

MediaWiki\Page\WikiPage::replaceSectionContent	(		$sectionId,
		Content	$sectionContent,
			$sectionTitle = '',
			$edittime = null )

Parameters

string \| int \| null \| false	$sectionId	Section identifier as a number or string (e.g. 0, 1 or 'T-1'), null/false or an empty string for the whole page or 'new' for a new section.
Content	$sectionContent	New content of the section.
string	$sectionTitle	New section's subject, only if $section is "new".
string \| null	$edittime	Revision timestamp or null to use the latest revision.

Returns: Content|null New complete article content, or null if error.

Since: 1.21

Deprecated: since 1.24, use replaceSectionAtRev instead

Definition at line 1428 of file WikiPage.php.

◆ setTimestamp()

MediaWiki\Page\WikiPage::setTimestamp ( $ts )

Set the page timestamp (use only to avoid DB queries)

Parameters

string $ts MW timestamp of last article revision

Returns: void

Definition at line 801 of file WikiPage.php.

◆ shouldCheckParserCache()

MediaWiki\Page\WikiPage::shouldCheckParserCache	(	ParserOptions	$parserOptions,
			$oldId )

Should the parser cache be used?

Parameters

ParserOptions	$parserOptions	ParserOptions to check
int	$oldId

Returns: bool

Definition at line 1096 of file WikiPage.php.

◆ supportsSections()

MediaWiki\Page\WikiPage::supportsSections ( )

Returns true if this page's content model supports sections.

Returns: bool

Todo

The skin should check this and not offer section functionality if sections are not supported.

The EditPage should check this and not offer section functionality if sections are not supported.

Definition at line 1411 of file WikiPage.php.

◆ toPageRecord()

MediaWiki\Page\WikiPage::toPageRecord ( )

Returns the page represented by this WikiPage as a PageStoreRecord.

The PageRecord returned by this method is guaranteed to be immutable.

It is preferred to use this method rather than using the WikiPage as a PageIdentity directly.

Since: 1.36

Exceptions

PreconditionException if the page does not exist.

Returns: ExistingPageRecord

Definition at line 2997 of file WikiPage.php.

◆ triggerOpportunisticLinksUpdate()

MediaWiki\Page\WikiPage::triggerOpportunisticLinksUpdate ( ParserOutput $parserOutput )

Opportunistically enqueue link update jobs after a fresh parser output was generated.

This method should only be called by PoolWorkArticleViewCurrent, after a page view experienced a miss from the ParserCache, and a new ParserOutput was generated. Specifically, for load reasons, this method must not get called during page views that use a cached ParserOutput.

Since: 1.25

Access: internal: For use by PoolWorkArticleViewCurrent

Parameters

ParserOutput $parserOutput Current version page output

Definition at line 2809 of file WikiPage.php.

References MediaWiki\Parser\ParserOutput\getCacheExpiry(), MediaWiki\Parser\CacheTime\getCacheTime(), MediaWiki\Parser\ParserOutput\getOutputFlag(), and MediaWiki\Parser\ParserOutput\hasReducedExpiry().

◆ updateParserCache()

MediaWiki\Page\WikiPage::updateParserCache ( array $options = [] )

Update the parser cache.

Note: This does not update links tables. Use doSecondaryDataUpdates() for that.

Parameters

array

$options

causeAction: an arbitrary string identifying the reason for the update. See DataUpdate::getCauseAction(). (default 'edit-page')
causeAgent: name of the user who caused the update (string, defaults to the user who created the revision)

Since: 1.32

Definition at line 1897 of file WikiPage.php.

◆ updateRevisionOn()

MediaWiki\Page\WikiPage::updateRevisionOn	(		$dbw,
		RevisionRecord	$revision,
			$lastRevision = null,
			$lastRevIsRedirect = null )

Update the page record to point to a newly saved revision.

Access: internal: Low level interface, not safe for use in extensions!

Todo: Factor out into a PageStore service, or move into PageUpdater.

Parameters

IDatabase	$dbw
RevisionRecord	$revision	For ID number, and text used to set length and redirect status fields.
int \| null	$lastRevision	If given, will not overwrite the page field when different from the currently set value. Giving 0 indicates the new page flag should be set on.
bool \| null	$lastRevIsRedirect	If given, will optimize adding and removing rows in redirect table.

Returns: bool Success; false if the page row was missing or page_latest changed

Definition at line 1310 of file WikiPage.php.

References MediaWiki\Revision\RevisionRecord\getContent(), MediaWiki\Revision\RevisionRecord\getId(), MediaWiki\Revision\RevisionRecord\getMainContentModel(), and MediaWiki\Revision\RevisionRecord\getTimestamp().

◆ wasLoadedFrom()

MediaWiki\Page\WikiPage::wasLoadedFrom ( $from )

Checks whether the page data was loaded using the given database access mode (or better).

Parameters

string | int

$from

One of the following:

IDBAccessObject::READ_NORMAL to get from a replica DB.
IDBAccessObject::READ_LATEST to get from the primary DB.
IDBAccessObject::READ_LOCKING to get from the primary DB using SELECT FOR UPDATE.
"fromdb", alias for IDBAccessObject::READ_NORMAL (deprecated Since 1.46)
"fromdbmaster", alias for IDBAccessObject::READ_LATEST (deprecated Since 1.46)
"forupdate", alias for IDBAccessObject::READ_LOCKING (deprecated Since 1.46)

Returns: bool

Since: 1.32

Definition at line 462 of file WikiPage.php.

Member Data Documentation

◆ $mDataLoaded

bool MediaWiki\Page\WikiPage::$mDataLoaded = false

protected

Note: for access by subclasses only

Definition at line 100 of file WikiPage.php.

◆ $mDataLoadedFrom

int MediaWiki\Page\WikiPage::$mDataLoadedFrom = IDBAccessObject::READ_NONE

protected

One of the READ_* constants.

Definition at line 133 of file WikiPage.php.

◆ $mId

int null MediaWiki\Page\WikiPage::$mId = null

protected

Definition at line 128 of file WikiPage.php.

◆ $mLanguage

string null MediaWiki\Page\WikiPage::$mLanguage = null

protected

Definition at line 153 of file WikiPage.php.

◆ $mLatest

int false MediaWiki\Page\WikiPage::$mLatest = false

protected

False means "not loaded".

Note: for access by subclasses only

Definition at line 117 of file WikiPage.php.

◆ $mLinksUpdated

string MediaWiki\Page\WikiPage::$mLinksUpdated = '19700101000000'

protected

Definition at line 158 of file WikiPage.php.

◆ $mPreparedEdit

PreparedEdit false MediaWiki\Page\WikiPage::$mPreparedEdit = false

protected

Map of cache fields (text, parser output, etc.) for a proposed/new edit.

Note: for access by subclasses only

Definition at line 123 of file WikiPage.php.

◆ $mTimestamp

string MediaWiki\Page\WikiPage::$mTimestamp = ''

protected

Timestamp of the latest revision or empty string if not loaded.

Definition at line 143 of file WikiPage.php.

◆ $mTitle

Title MediaWiki\Page\WikiPage::$mTitle

protected

Note: for access by subclasses only

Definition at line 94 of file WikiPage.php.

Referenced by MediaWiki\Page\WikiPage\__clone(), and MediaWiki\Page\WikiCategoryPage\doPurge().

◆ $mTouched

string MediaWiki\Page\WikiPage::$mTouched = '19700101000000'

protected

Definition at line 148 of file WikiPage.php.

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

includes/Page/WikiPage.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __clone()

◆ __toString()

◆ __wakeup()

◆ canExist()

◆ checkFlags()

◆ checkTouched()

◆ clear()

◆ clearCacheFields()

◆ clearPreparedEdit()

◆ convertSelectType()

◆ doDeleteArticleReal()

◆ doEditUpdates()

◆ doPurge()

◆ doSecondaryDataUpdates()

◆ doUpdateRestrictions()

◆ doUserEditContent()

◆ doViewUpdates()

◆ exists()

◆ followRedirect()

◆ formatExpiry()

◆ getActionOverrides()

◆ getAutoDeleteReason()

◆ getCategories()

◆ getComment()

◆ getContent()

◆ getContentHandler()

◆ getContentModel()

◆ getContributors()

◆ getCreator()

◆ getCurrentUpdate()

◆ getDBkey()

◆ getHiddenCategories()

◆ getId()

◆ getLanguage()

◆ getLatest()

◆ getLinksTimestamp()

◆ getMinorEdit()

◆ getNamespace()

◆ getParserOutput()

◆ getQueryInfo()

◆ getRedirectTarget()

◆ getRedirectURL()

◆ getRevisionRecord()

◆ getSourceURL()

◆ getTimestamp()

◆ getTitle()

◆ getTouched()

◆ getUser()

◆ getUserText()

◆ getWikiDisplayName()

◆ getWikiId()

◆ hasDifferencesOutsideMainSlot()

◆ hasViewableContent()

◆ insertNullProtectionRevision()

◆ insertOn()

◆ insertRedirectEntry()

◆ isBatchedDelete()

◆ isCountable()

◆ isLocal()

◆ isNew()

◆ isRedirect()

◆ isSamePageAs()

◆ loadFromRow()

◆ loadLastEdit()

◆ loadPageData()

◆ lockAndGetLatest()

◆ makeParserOptions()

◆ makeParserOptionsFromTitleAndModel()

◆ newPageUpdater()

◆ onArticleCreate()

◆ onArticleDelete()