Interface for a page that is (or could be, or used to be) an editable wiki page. More...

Inherited by MediaWiki\Page\PageIdentityValue, and MediaWiki\Page\PageRecord.

Collaboration diagram for MediaWiki\Page\ProperPageIdentity:

[legend]

Public Member Functions
	canExist ()
	Always true.

	getDBkey ()
	Get the page title in DB key form.

	getId ( $wikiId=self::LOCAL)
	Returns the page ID.

	getWikiId ()
	Get the ID of the wiki this page belongs to.

Public Member Functions inherited from MediaWiki\Page\PageIdentity
	exists ()
	Checks if the page currently exists.

Public Member Functions inherited from MediaWiki\Page\PageReference
	__toString ()
	Returns an informative human readable unique representation of the page identity, for use as a cache key and for logging and debugging.

	getNamespace ()
	Returns the page's namespace number.

	isSamePageAs (PageReference $other)
	Checks whether the given PageReference refers to the same page as this PageReference.

Public Member Functions inherited from MediaWiki\DAO\WikiAwareEntity
	assertWiki ( $wikiId)
	Throws if $wikiId is different from the return value of getWikiId().

Detailed Description

Interface for a page that is (or could be, or used to be) an editable wiki page.

Note: In contrast to PageIdentity, a ProperPageIdentity is guaranteed to represent an actual editable (or creatable) page. Eventually, PageIdentity is intended to adopt the same contract. At that point, ProperPageIdentity may become an alias for PageIdentity.; For compatibility with the WikiPage class, ProperPageIdentity instances may be mutable, and return different values from methods such as getId() or exist() at different times. In the future, the contract of this interface is intended to be changed to disallow this.

Stability: stable: to type

Since: 1.36

Definition at line 42 of file ProperPageIdentity.php.

Member Function Documentation

◆ canExist()

MediaWiki\Page\ProperPageIdentity::canExist ( )

Always true.

Implementations must ensure that no "improper" instances can be created.

Returns: true

Implements MediaWiki\Page\PageIdentity.

Implemented in MediaWiki\Page\PageIdentityValue, and WikiPage.

◆ getDBkey()

MediaWiki\Page\ProperPageIdentity::getDBkey ( )

Get the page title in DB key form.

This should always return a valid DB key.

Returns: string

Implements MediaWiki\Page\PageReference.

Implemented in WikiPage.

◆ getId()

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

Returns the page ID.

Will return 0 if the page does not currently exist.

Parameters

string | false $wikiId Must be provided when accessing the ID of a non-local PageIdentity, to prevent data corruption when using a PageIdentity belonging to one wiki in the context of another. Should be omitted if expecting the local wiki.

Exceptions

PreconditionException if this PageIdentity does not belong to the wiki identified by $wikiId.