A codec for MediaWiki page titles. More...

Inheritance diagram for MediaWikiTitleCodec:

Collaboration diagram for MediaWikiTitleCodec:

Public Member Functions
	__construct (Language $language, GenderCache $genderCache, $localInterwikis=[])

	formatTitle ($namespace, $text, $fragment= '', $interwiki= '')

	getFullText (LinkTarget $title)

	getNamespaceName ($namespace, $text)

	getPrefixedDBkey (LinkTarget $target)

	getPrefixedText (LinkTarget $title)

	getText (LinkTarget $title)

	parseTitle ($text, $defaultNamespace)
	Parses the given text and constructs a TitleValue. More...

	splitTitleString ($text, $defaultNamespace=NS_MAIN)
	Normalizes and splits a title string. More...

Static Public Member Functions
static	getTitleInvalidRegex ()
	Returns a simple regex that will match on characters and sequences invalid in titles. More...

Protected Attributes
GenderCache	$genderCache

Language	$language

string[]	$localInterwikis

Detailed Description

A codec for MediaWiki page titles.

Note: Normalization and validation is applied while parsing, not when formatting. It's possible to construct a TitleValue with an invalid title, and use MediaWikiTitleCodec to generate an (invalid) title string from it. TitleValues should be constructed only via parseTitle() or from a (semi)trusted source, such as the database.

See also: https://www.mediawiki.org/wiki/Requests_for_comment/TitleValue

Since: 1.23

Definition at line 37 of file MediaWikiTitleCodec.php.

Constructor & Destructor Documentation

MediaWikiTitleCodec::__construct	(	Language	$language,
		GenderCache	$genderCache,
			$localInterwikis = `[]`
	)

Parameters

Language	$language	The language object to use for localizing namespace names.
GenderCache	$genderCache	The gender cache for generating gendered namespace names
	string[]\|string	$localInterwikis

Definition at line 58 of file MediaWikiTitleCodec.php.

References $genderCache, $language, and array().

Member Function Documentation

MediaWikiTitleCodec::formatTitle	(	$namespace,
		$text,
		$fragment = `''`,
		$interwiki = `''`
	)

See also: TitleFormatter::formatTitle()

Parameters

int \| bool	$namespace	The namespace ID (or false, if the namespace should be ignored)
string	$text	The page title. Should be valid. Only minimal normalization is applied. Underscores will be replaced.
string	$fragment	The fragment name (may be empty).
string	$interwiki	The interwiki name (may be empty).

Exceptions

InvalidArgumentException If the namespace is invalid

Returns: string

Implements TitleFormatter.

Definition at line 106 of file MediaWikiTitleCodec.php.

References $e, and getNamespaceName().

Referenced by getFullText(), getPrefixedText(), and getText().

MediaWikiTitleCodec::getFullText ( LinkTarget $title )

See also: TitleFormatter::getText()

Parameters

LinkTarget $title

Returns: string

Implements TitleFormatter.

Definition at line 228 of file MediaWikiTitleCodec.php.

References formatTitle(), MediaWiki\Linker\LinkTarget\getFragment(), MediaWiki\Linker\LinkTarget\getInterwiki(), MediaWiki\Linker\LinkTarget\getNamespace(), and MediaWiki\Linker\LinkTarget\getText().

MediaWikiTitleCodec::getNamespaceName	(	$namespace,
		$text
	)

See also: TitleFormatter::getNamespaceName()

Parameters

int	$namespace
string	$text

Exceptions

InvalidArgumentException If the namespace is invalid

Returns: string

Implements TitleFormatter.

Definition at line 75 of file MediaWikiTitleCodec.php.

References $name, and MWNamespace\hasGenderDistinction().

Referenced by formatTitle(), and getPrefixedDBkey().

MediaWikiTitleCodec::getPrefixedDBkey ( LinkTarget $target )

Since: 1.27

See also: TitleFormatter::getPrefixedDBkey()

Parameters

LinkTarget $target

Returns: string

Implements TitleFormatter.

Definition at line 196 of file MediaWikiTitleCodec.php.

References $e, MediaWiki\Linker\LinkTarget\getInterwiki(), MediaWiki\Linker\LinkTarget\getNamespace(), getNamespaceName(), MediaWiki\Linker\LinkTarget\getText(), and MediaWiki\Linker\LinkTarget\isExternal().

MediaWikiTitleCodec::getPrefixedText ( LinkTarget $title )

See also: TitleFormatter::getText()

Parameters

LinkTarget $title

Returns: string

Implements TitleFormatter.

Definition at line 181 of file MediaWikiTitleCodec.php.

References formatTitle(), MediaWiki\Linker\LinkTarget\getInterwiki(), MediaWiki\Linker\LinkTarget\getNamespace(), and MediaWiki\Linker\LinkTarget\getText().

MediaWikiTitleCodec::getText ( LinkTarget $title )

See also: TitleFormatter::getText()

Parameters

LinkTarget $title

Returns: string $title->getText()

Implements TitleFormatter.

Definition at line 170 of file MediaWikiTitleCodec.php.

References formatTitle(), and MediaWiki\Linker\LinkTarget\getText().

static MediaWikiTitleCodec::getTitleInvalidRegex ( )

static

Returns a simple regex that will match on characters and sequences invalid in titles.

Note that this doesn't pick up many things that could be wrong with titles, but that replacing this regex with something valid will make many titles valid. Previously Title::getTitleInvalidRegex()

Returns: string Regex string

Since: 1.25

Definition at line 465 of file MediaWikiTitleCodec.php.

References is(), Title\legalChars(), not, the, and URL.

Referenced by Title\getTitleInvalidRegex(), and Language\isValidCode().

MediaWikiTitleCodec::parseTitle	(	$text,
		$defaultNamespace
	)

Parses the given text and constructs a TitleValue.

Normalization is applied according to the rules appropriate for the form specified by $form.

Parameters

string	$text	The text to parse
int	$defaultNamespace	Namespace to assume per default (usually NS_MAIN)

Exceptions

MalformedTitleException

Returns: TitleValue

Implements TitleParser.

Definition at line 144 of file MediaWikiTitleCodec.php.

References splitTitleString().

MediaWikiTitleCodec::splitTitleString	(	$text,
		$defaultNamespace = `NS_MAIN`
	)

Normalizes and splits a title string.

This function removes illegal characters, splits off the interwiki and namespace prefixes, sets the other forms, and canonicalizes everything.

Todo:: this method is only exposed as a temporary measure to ease refactoring. It was copied with minimal changes from Title::secureAndSplit().

Todo:: This method should be split up and an appropriate interface defined for use by the Title class.

Parameters

string	$text
int	$defaultNamespace

Exceptions

MalformedTitleException If $text is not a valid title string.

Returns: array A map with the fields 'interwiki', 'fragment', 'namespace', 'user_case_dbkey', and 'dbkey'.

Definition at line 257 of file MediaWikiTitleCodec.php.

References $matches, as, Title\capitalize(), Interwiki\isValidInterwiki(), Title\newMainPage(), NS_MAIN, NS_SPECIAL, NS_TALK, NS_USER, NS_USER_TALK, Message\numParam(), processing, IP\sanitizeIP(), the, and UTF8_REPLACEMENT.

Referenced by parseTitle().

Member Data Documentation

GenderCache MediaWikiTitleCodec::$genderCache

protected

Definition at line 46 of file MediaWikiTitleCodec.php.

Referenced by __construct().

Language MediaWikiTitleCodec::$language

protected

Definition at line 41 of file MediaWikiTitleCodec.php.

Referenced by __construct().

string [] MediaWikiTitleCodec::$localInterwikis

protected

Definition at line 51 of file MediaWikiTitleCodec.php.

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

includes/title/MediaWikiTitleCodec.php

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation