Handles searching prefixes of titles and finding any page names that match. More...

Inheritance diagram for PrefixSearch:

Public Member Functions
	defaultSearchBackend ($namespaces, $search, $limit, $offset)
	Unless overridden by PrefixSearchBackend hook... More...

	search ($search, $limit, $namespaces=[], $offset=0)
	Do a prefix search of titles and return a list of matching page names. More...

	searchWithVariants ($search, $limit, array $namespaces, $offset=0)
	Do a prefix search for all possible variants of the prefix. More...

Static Public Member Functions
static	titleSearch ($search, $limit, $namespaces=[], $offset=0)
	Do a prefix search of titles and return a list of matching page names. More...

Protected Member Functions
	extractNamespace ($input)
	Figure out if given input contains an explicit namespace. More...

	searchBackend ($namespaces, $search, $limit, $offset)
	Do a prefix search of titles and return a list of matching page names. More...

	specialSearch ($search, $limit, $offset)
	Prefix search special-case for Special: namespace. More...

	strings (array $strings)
	When implemented in a descendant class, receives an array of titles as strings and returns either an unmodified array or an array of Title objects corresponding to strings received. More...

	titles (array $titles)
	When implemented in a descendant class, receives an array of Title objects and returns either an unmodified array or an array of strings corresponding to titles passed to it. More...

	validateNamespaces ($namespaces)
	Validate an array of numerical namespace indexes. More...

Private Member Functions
	handleResultFromHook ($srchres, $namespaces, $search, $limit, $offset)

Detailed Description

Handles searching prefixes of titles and finding any page names that match.

Used largely by the OpenSearch implementation.

Deprecated:: Since 1.27, Use SearchEngine::prefixSearchSubpages or SearchEngine::completionSearch

Definition at line 30 of file PrefixSearch.php.

Member Function Documentation

PrefixSearch::defaultSearchBackend	(	$namespaces,
		$search,
		$limit,
		$offset
	)

Unless overridden by PrefixSearchBackend hook...

This is case-sensitive (First character may be automatically capitalized by Title::secureAndSpit() later on depending on $wgCapitalLinks)

Parameters

array \| null	$namespaces	Namespaces to search in
string	$search	Term
int	$limit	Max number of items to return
int	$offset	Number of items to skip

Returns: Title[] Array of Title objects

Definition at line 291 of file PrefixSearch.php.

References $dbr, $limit, $namespaces, $options, $res, $title, as, DB_REPLICA, LIST_AND, LIST_OR, Title\makeTitleSafe(), TitleArray\newFromResult(), NS_MAIN, NS_SPECIAL, specialSearch(), and wfGetDB().

Referenced by searchBackend(), and SearchEngine\simplePrefixSearch().

PrefixSearch::extractNamespace ( $input )

protected

Figure out if given input contains an explicit namespace.

Parameters

string $input

Returns: false|array Array of namespace and remaining text, or false if no namespace given.

Definition at line 79 of file PrefixSearch.php.

References $title, Title\newFromText(), and NS_MAIN.

Referenced by search().

PrefixSearch::handleResultFromHook	(	$srchres,
		$namespaces,
		$search,
		$limit,
		$offset
	)

private

Definition at line 189 of file PrefixSearch.php.

References $limit, and $namespaces.

Referenced by searchBackend().

PrefixSearch::search	(	$search,
		$limit,
		$namespaces = `[]`,
		$offset = `0`
	)

Do a prefix search of titles and return a list of matching page names.

Parameters

string	$search
int	$limit
array	$namespaces	Used if query is not explicitly prefixed
int	$offset	How many results to offset from the beginning

Returns: array Array of strings or Title objects

Definition at line 55 of file PrefixSearch.php.

References $limit, $namespaces, extractNamespace(), list, Hooks\run(), searchBackend(), and validateNamespaces().

Referenced by searchWithVariants(), PrefixSearchTest\testSearch(), PrefixSearchTest\testSearchBackend(), PrefixSearchTest\testSearchWithOffset(), and titleSearch().

PrefixSearch::searchBackend	(	$namespaces,
		$search,
		$limit,
		$offset
	)

protected

Do a prefix search of titles and return a list of matching page names.

Parameters

array	$namespaces
string	$search
int	$limit
int	$offset	How many results to offset from the beginning

Returns: array Array of strings

Definition at line 169 of file PrefixSearch.php.

References $limit, $namespaces, defaultSearchBackend(), handleResultFromHook(), NS_FILE, NS_MEDIA, NS_SPECIAL, Hooks\run(), specialSearch(), strings(), and titles().

Referenced by search().

PrefixSearch::searchWithVariants	(		$search,
			$limit,
		array	$namespaces,
			$offset = `0`
	)

Do a prefix search for all possible variants of the prefix.

Parameters

string	$search
int	$limit
array	$namespaces
int	$offset	How many results to offset from the beginning

Returns: array

Definition at line 118 of file PrefixSearch.php.

References $limit, $wgContLang, as, global, and search().

PrefixSearch::specialSearch	(	$search,
		$limit,
		$offset
	)

protected

Prefix search special-case for Special: namespace.

Parameters

string	$search	Term
int	$limit	Max number of items to return
int	$offset	Number of items to offset

Returns: array

Definition at line 209 of file PrefixSearch.php.

References $keys, $limit, $page, $special, $wgContLang, as, SpecialPageFactory\getNames(), SpecialPageFactory\getPage(), global, Title\makeTitleSafe(), NS_SPECIAL, and use.

Referenced by defaultSearchBackend(), and searchBackend().

PrefixSearch::strings ( array $strings )

abstractprotected

When implemented in a descendant class, receives an array of titles as strings and returns either an unmodified array or an array of Title objects corresponding to strings received.

Parameters

array $strings

Returns: array

Referenced by searchBackend().

PrefixSearch::titles ( array $titles )

abstractprotected

When implemented in a descendant class, receives an array of Title objects and returns either an unmodified array or an array of strings corresponding to titles passed to it.

Parameters

array $titles