Contain a class for special pages. More...

Inheritance diagram for SearchEngine:

[legend]

Collaboration diagram for SearchEngine:

[legend]

Public Member Functions
	augmentSearchResults (SearchResultSet $resultSet)
	Augment search results with extra data.

	completionSearch ( $search)
	Perform a completion search.

	completionSearchWithVariants ( $search)
	Perform a completion search with variants.

	defaultPrefixSearch ( $search)
	Simple prefix search for subpages.

	delete ( $id, $title)
	Delete an indexed page Title should be pre-processed.

	extractTitles (SearchSuggestionSet $completionResults)
	Extract titles from completion results.

	getFeatureData ( $feature)
	Way to retrieve custom data set by setFeatureData or by the engine itself.

	getNearMatcher (Config $config)
	Get service class to finding near matches.

	getProfiles ( $profileType, User $user=null)
	Get a list of supported profiles.

	getSearchIndexFields ()
	Get fields for search index.

	getSort ()
	Get the sort direction of the search results.

	getTextFromContent (Title $t, Content $c=null)
	Get the raw text for updating the index from a content object Nicer search backends could possibly do something cooler than just returning raw text.

	getValidSorts ()
	Get the valid sort directions.

	makeSearchFieldMapping ( $name, $type)
	Create a search field definition.

	normalizeText ( $string)
	When overridden in derived class, performs database-specific conversions on text to be used for searching or updating search index.

	replacePrefixes ( $query)
	Parse some common prefixes: all (search everything) or namespace names and set the list of namespaces of this class accordingly.

	searchArchiveTitle ( $term)
	Perform a title search in the article archive.

	searchText ( $term)
	Perform a full text search query and return a result set.

	searchTitle ( $term)
	Perform a title-only search query and return a result set.

	setFeatureData ( $feature, $data)
	Way to pass custom data for engines.

	setLimitOffset ( $limit, $offset=0)
	Set the maximum number of results to return and how many to skip before returning the first.

	setNamespaces ( $namespaces)
	Set which namespaces the search should include.

	setShowSuggestion ( $showSuggestion)
	Set whether the searcher should try to build a suggestion.

	setSort ( $sort)
	Set the sort direction of the search results.

	supports ( $feature)

	textAlreadyUpdatedForIndex ()
	If an implementation of SearchEngine handles all of its own text processing in getTextFromContent() and doesn't require SearchUpdate::updateText()'s rather silly handling, it should return true here instead.

	transformSearchTerm ( $term)
	Transform search term in cases when parts of the query came as different GET params (when supported), e.g.

	update ( $id, $title, $text)
	Create or update the search index record for the given page.

	updateTitle ( $id, $title)
	Update a search index record's title only.

Static Public Member Functions
static	create ( $type=null)
	Load up the appropriate search engine class for the currently active database backend, and return a configured instance.

static	defaultNamespaces ()
	An array of namespaces indexes to be searched by default.

static	getNearMatch ( $searchterm)
	If an exact title match can be found, or a very slightly close match, return the title.

static	getNearMatchResultSet ( $searchterm)
	Do a near match (see SearchEngine::getNearMatch) and wrap it into a SearchResultSet.

static	getSearchTypes ()
	Return the search engines we support.

static	legalSearchChars ( $type=self::CHARS_ALL)
	Get chars legal for search NOTE: usage as static is deprecated and preserved only as BC measure.

static	namespacesAsText ( $namespaces)
	Get a list of namespace names useful for showing in tooltips and preferences.

static	parseNamespacePrefixes ( $query)
	Parse some common prefixes: all (search everything) or namespace names.

static	searchableNamespaces ()
	Make a list of searchable namespaces and their canonical names.

static	userHighlightPrefs ()
	Find snippet highlight settings for all users.

static	userNamespaces ( $user)
	Extract default namespaces to search from the given user's settings, returning a list of index numbers.

Public Attributes
int[] null	$namespaces = [ NS_MAIN ]

string	$prefix = ''

const	CHARS_ALL = 1
	@const int flag for legalSearchChars: includes all chars allowed in a search query

const	CHARS_NO_SYNTAX = 2
	@const int flag for legalSearchChars: includes all chars allowed in a search term

const	COMPLETION_PROFILE_TYPE = 'completionSearchProfile'
	@const string profile type for completionSearch

const	FT_QUERY_INDEP_PROFILE_TYPE = 'fulltextQueryIndepProfile'
	@const string profile type for query independent ranking features

Protected Member Functions
	completionSearchBackend ( $search)
	Perform a completion search.

	normalizeNamespaces ( $search)
	Makes search simple string if it was namespaced.

	processCompletionResults ( $search, SearchSuggestionSet $suggestions)
	Process completion search results.

	simplePrefixSearch ( $search)
	Call out to simple search backend.

Static Protected Member Functions
static	defaultNearMatcher ()
	Get near matcher for default SearchEngine.

Protected Attributes
array	$features = []
	Feature values.

int	$limit = 10

int	$offset = 0

array string	$searchTerms = []

bool	$showSuggestion = true

Private Attributes
	$sort = 'relevance'

Detailed Description

Contain a class for special pages.

Definition at line 34 of file SearchEngine.php.

Member Function Documentation

◆ augmentSearchResults()

SearchEngine::augmentSearchResults ( SearchResultSet $resultSet )

Augment search results with extra data.

Parameters

SearchResultSet $resultSet

Definition at line 777 of file SearchEngine.php.

References $name, $rowAugmentors, and SearchResultSet\setAugmentedData().

◆ completionSearch()

SearchEngine::completionSearch ( $search )

Perform a completion search.

Parameters

string $search

Returns: SearchSuggestionSet

Definition at line 506 of file SearchEngine.php.

References completionSearchBackend(), SearchSuggestionSet\emptySuggestionSet(), normalizeNamespaces(), and processCompletionResults().

Referenced by completionSearchWithVariants(), and SearchEnginePrefixTest\testSearchBackend().

◆ completionSearchBackend()

SearchEngine::completionSearchBackend ( $search )

protected

Perform a completion search.

Does not resolve namespaces and does not check variants. Search engine implementations may want to override this function.

Parameters

string $search

Returns: SearchSuggestionSet

Definition at line 481 of file SearchEngine.php.

References SearchSuggestionSet\fromStrings(), SearchSuggestionSet\fromTitles(), namespaces, NS_SPECIAL, and simplePrefixSearch().

Referenced by completionSearch(), and completionSearchWithVariants().

◆ completionSearchWithVariants()

SearchEngine::completionSearchWithVariants ( $search )

Perform a completion search with variants.

Parameters

string $search

Returns: SearchSuggestionSet

Definition at line 519 of file SearchEngine.php.

References $wgContLang, completionSearch(), completionSearchBackend(), SearchSuggestionSet\emptySuggestionSet(), normalizeNamespaces(), processCompletionResults(), and setLimitOffset().

◆ create()

static SearchEngine::create ( $type = null )

static

Load up the appropriate search engine class for the currently active database backend, and return a configured instance.

Deprecated: since 1.27; Use SearchEngineFactory::create

Parameters

string $type Type of search backend, if not the default

Returns: SearchEngine

Definition at line 685 of file SearchEngine.php.

References $type.

◆ defaultNamespaces()

static SearchEngine::defaultNamespaces ( )

static

An array of namespaces indexes to be searched by default.

Deprecated: since 1.27; use SearchEngineConfig::defaultNamespaces()

Returns: array

Definition at line 663 of file SearchEngine.php.

◆ defaultNearMatcher()

static SearchEngine::defaultNearMatcher ( )

staticprotected

Get near matcher for default SearchEngine.

Returns: SearchNearMatcher

Definition at line 187 of file SearchEngine.php.

◆ defaultPrefixSearch()

SearchEngine::defaultPrefixSearch ( $search )

Simple prefix search for subpages.

Parameters

string $search

Returns: Title[]

Definition at line 617 of file SearchEngine.php.

References normalizeNamespaces(), and simplePrefixSearch().

◆ delete()

SearchEngine::delete	(		$id,
			$title )

Delete an indexed page Title should be pre-processed.

STUB

Parameters

int	$id	Page id that was deleted
string	$title	Title of page that was deleted

Reimplemented in SearchMySQL.

Definition at line 405 of file SearchEngine.php.

◆ extractTitles()

SearchEngine::extractTitles ( SearchSuggestionSet $completionResults )

Extract titles from completion results.

Parameters

SearchSuggestionSet $completionResults

Returns: Title[]

Definition at line 551 of file SearchEngine.php.

◆ getFeatureData()

SearchEngine::getFeatureData ( $feature )

Way to retrieve custom data set by setFeatureData or by the engine itself.

Since: 1.29

Parameters

string $feature feature name

Returns: mixed the feature value or null if unset

Definition at line 140 of file SearchEngine.php.

◆ getNearMatch()

static SearchEngine::getNearMatch ( $searchterm )

static

If an exact title match can be found, or a very slightly close match, return the title.

If no match, returns NULL.

Deprecated: since 1.27; Use SearchEngine::getNearMatcher()

Parameters

string $searchterm

Returns: Title

Definition at line 199 of file SearchEngine.php.

◆ getNearMatcher()

SearchEngine::getNearMatcher ( Config $config )

Get service class to finding near matches.

Parameters

Config $config Configuration to use for the matcher.

Returns: SearchNearMatcher

Definition at line 178 of file SearchEngine.php.

References $wgContLang.

◆ getNearMatchResultSet()

static SearchEngine::getNearMatchResultSet ( $searchterm )

static

Do a near match (see SearchEngine::getNearMatch) and wrap it into a SearchResultSet.

Deprecated: since 1.27; Use SearchEngine::getNearMatcher()

Parameters

string $searchterm

Returns: SearchResultSet

Definition at line 210 of file SearchEngine.php.

◆ getProfiles()

SearchEngine::getProfiles	(		$profileType,
		User	$user = null )

Get a list of supported profiles.

Some search engine implementations may expose specific profiles to fine-tune its behaviors. The profile can be passed as a feature data with setFeatureData( $profileType, $profileName ) The array returned by this function contains the following keys:

name: the profile name to use with setFeatureData
desc-message: the i18n description
default: set to true if this profile is the default

Since: 1.28

Parameters

string	$profileType	the type of profiles
User \| null	$user	the user requesting the list of profiles

Returns: array|null the list of profiles or null if none available

Definition at line 714 of file SearchEngine.php.

◆ getSearchIndexFields()

SearchEngine::getSearchIndexFields ( )

Get fields for search index.

Since: 1.28

Returns: SearchIndexField[] Index field definitions for all content handlers

Definition at line 735 of file SearchEngine.php.

References $e, and $handler.

◆ getSearchTypes()

static SearchEngine::getSearchTypes ( )

static

Return the search engines we support.

If only $wgSearchType is set, it'll be an array of just that one item.

Deprecated: since 1.27; use SearchEngineConfig::getSearchTypes()

Returns: array

Definition at line 695 of file SearchEngine.php.

◆ getSort()

SearchEngine::getSort ( )

Get the sort direction of the search results.

Since: 1.25

Returns: string

Definition at line 300 of file SearchEngine.php.

References $sort.

◆ getTextFromContent()

SearchEngine::getTextFromContent	(	Title	$t,
		Content	$c = null )

Get the raw text for updating the index from a content object Nicer search backends could possibly do something cooler than just returning raw text.

Todo: This isn't ideal, we'd really like to have content-specific handling here

Parameters

Title	$t	Title we're indexing
Content	$c	Content of the page to index

Returns: string

Definition at line 419 of file SearchEngine.php.

◆ getValidSorts()

SearchEngine::getValidSorts ( )

Get the valid sort directions.

All search engines support 'relevance' but others might support more. The default in all implementations should be 'relevance.'

Since: 1.25

Returns: string[] the valid sort directions for setSort

Definition at line 274 of file SearchEngine.php.

Referenced by setSort().

◆ legalSearchChars()

static SearchEngine::legalSearchChars ( $type = self::CHARS_ALL )

static

Get chars legal for search NOTE: usage as static is deprecated and preserved only as BC measure.

Parameters

int $type type of search chars (see self::CHARS_ALL and self::CHARS_NO_SYNTAX). Defaults to CHARS_ALL

Returns: string

Reimplemented in SearchMySQL, SearchOracle, and SearchSqlite.

Definition at line 221 of file SearchEngine.php.

Referenced by SearchDatabase\filter(), SearchUpdate\getNormalizedTitle(), and SearchMssql\parseQuery().

◆ makeSearchFieldMapping()

SearchEngine::makeSearchFieldMapping	(		$name,
			$type )

Create a search field definition.

Specific search engines should override this method to create search fields.

Parameters

string	$name
int	$type	One of the types in SearchIndexField::INDEX_TYPE_*

Returns: SearchIndexField

Since: 1.28

Definition at line 726 of file SearchEngine.php.

◆ namespacesAsText()

static SearchEngine::namespacesAsText ( $namespaces )

static

Get a list of namespace names useful for showing in tooltips and preferences.

Deprecated: since 1.27; use SearchEngineConfig::namespacesAsText()

Parameters

array $namespaces

Returns: array

Definition at line 674 of file SearchEngine.php.

References $namespaces.

◆ normalizeNamespaces()

SearchEngine::normalizeNamespaces ( $search )

protected

Makes search simple string if it was namespaced.

Sets namespaces of the search to namespaces extracted from string.

Parameters

string $search

Returns: string Simplified search string

Definition at line 440 of file SearchEngine.php.

References $namespaces, NS_FILE, NS_MAIN, NS_MEDIA, and setNamespaces().

Referenced by completionSearch(), completionSearchWithVariants(), and defaultPrefixSearch().

◆ normalizeText()

SearchEngine::normalizeText ( $string )

When overridden in derived class, performs database-specific conversions on text to be used for searching or updating search index.

Default implementation does nothing (simply returns $string).

Parameters

string $string String to process

Returns: string

Reimplemented in SearchMySQL.

Definition at line 155 of file SearchEngine.php.

References $wgContLang.

Referenced by SearchUpdate\getNormalizedTitle().

◆ parseNamespacePrefixes()

static SearchEngine::parseNamespacePrefixes ( $query )

static

Parse some common prefixes: all (search everything) or namespace names.

Parameters

string $query

Returns: false|array false if no namespace was extracted, an array with the parsed query at index 0 and an array of namespaces at index 1 (or null for all namespaces).

Definition at line 330 of file SearchEngine.php.

References $query, $wgContLang, and wfMessage().

◆ processCompletionResults()

SearchEngine::processCompletionResults	(		$search,
		SearchSuggestionSet	$suggestions )

protected

Process completion search results.

Resolves the titles and rescores.

Parameters

string	$search
SearchSuggestionSet	$suggestions

Returns: SearchSuggestionSet

Definition at line 564 of file SearchEngine.php.

References $titles, SearchSuggestion\fromTitle(), SearchSuggestionSet\map(), namespaces, SearchSuggestionSet\prepend(), SearchSuggestionSet\rescore(), and SearchSuggestionSet\shrink().

Referenced by completionSearch(), and completionSearchWithVariants().

◆ replacePrefixes()

SearchEngine::replacePrefixes ( $query )

Parse some common prefixes: all (search everything) or namespace names and set the list of namespaces of this class accordingly.

Parameters

string $query

Returns: string

Definition at line 312 of file SearchEngine.php.

References $query, and namespaces.

◆ searchableNamespaces()

static SearchEngine::searchableNamespaces ( )

static

Make a list of searchable namespaces and their canonical names.

Deprecated: since 1.27; use SearchEngineConfig::searchableNamespaces()

Returns: array

Definition at line 643 of file SearchEngine.php.

Referenced by setNamespaces().

◆ searchArchiveTitle()

SearchEngine::searchArchiveTitle ( $term )

Perform a title search in the article archive.

NOTE: these results still should be filtered by matching against PageArchive, permissions checks etc The results returned by this methods are only sugegstions and may not end up being shown to the user.

Parameters

string $term Raw search term

Returns: Status<Title[]>

Since: 1.29

Definition at line 92 of file SearchEngine.php.

◆ searchText()

SearchEngine::searchText ( $term )

Perform a full text search query and return a result set.

If full text searches are not supported or disabled, return null. STUB

Parameters

string $term Raw search term

Returns: SearchResultSet|Status|null

Reimplemented in SearchMssql, SearchMySQL, SearchOracle, SearchPostgres, and SearchSqlite.

Definition at line 77 of file SearchEngine.php.

◆ searchTitle()

SearchEngine::searchTitle ( $term )

Perform a title-only search query and return a result set.

If title searches are not supported or disabled, return null. STUB

Parameters

string $term Raw search term

Returns: SearchResultSet|null

Reimplemented in SearchMssql, SearchMySQL, SearchOracle, SearchPostgres, and SearchSqlite.

Definition at line 104 of file SearchEngine.php.

◆ setFeatureData()

SearchEngine::setFeatureData	(		$feature,
			$data )

Way to pass custom data for engines.

Since: 1.18

Parameters

string	$feature
mixed	$data

Definition at line 129 of file SearchEngine.php.

◆ setLimitOffset()

SearchEngine::setLimitOffset	(		$limit,
			$offset = 0 )

Set the maximum number of results to return and how many to skip before returning the first.

Parameters

int	$limit
int	$offset

Definition at line 232 of file SearchEngine.php.

Referenced by completionSearchWithVariants(), and SearchEnginePrefixTest\testSearchBackend().

◆ setNamespaces()

SearchEngine::setNamespaces ( $namespaces )

Set which namespaces the search should include.

Give an array of namespace index numbers.

Parameters

int[] | null $namespaces

Definition at line 243 of file SearchEngine.php.

References $namespaces, namespaces, searchableNamespaces(), and use.

Referenced by normalizeNamespaces().

◆ setShowSuggestion()

SearchEngine::setShowSuggestion ( $showSuggestion )

Set whether the searcher should try to build a suggestion.

Note: some searchers don't support building a suggestion in the first place and others don't respect this flag.

Parameters

bool $showSuggestion Should the searcher try to build suggestions

Definition at line 263 of file SearchEngine.php.

◆ setSort()

SearchEngine::setSort ( $sort )

Set the sort direction of the search results.

Must be one returned by SearchEngine::getValidSorts()

Since: 1.25

Exceptions

InvalidArgumentException

Parameters

string $sort sort direction for query result

Definition at line 286 of file SearchEngine.php.

References $sort, and getValidSorts().

◆ simplePrefixSearch()

SearchEngine::simplePrefixSearch ( $search )

protected

Call out to simple search backend.

Defaults to TitlePrefixSearch.

Parameters

string $search

Returns: Title[]

Definition at line 632 of file SearchEngine.php.

References PrefixSearch\defaultSearchBackend(), and namespaces.

Referenced by completionSearchBackend(), and defaultPrefixSearch().

◆ supports()

SearchEngine::supports ( $feature )

Since: 1.18

Parameters

string $feature

Returns: bool

Reimplemented in SearchMySQL.

Definition at line 113 of file SearchEngine.php.

◆ textAlreadyUpdatedForIndex()

SearchEngine::textAlreadyUpdatedForIndex ( )

If an implementation of SearchEngine handles all of its own text processing in getTextFromContent() and doesn't require SearchUpdate::updateText()'s rather silly handling, it should return true here instead.

Returns: bool

Definition at line 430 of file SearchEngine.php.

◆ transformSearchTerm()

SearchEngine::transformSearchTerm ( $term )

Transform search term in cases when parts of the query came as different GET params (when supported), e.g.

for prefix queries: search=test&prefix=Main_Page/Archive -> test prefix:Main Page/Archive

Parameters

string $term

Returns: string

Definition at line 169 of file SearchEngine.php.

References $term.

◆ update()

SearchEngine::update	(	$id,
		$title,
		$text )

Create or update the search index record for the given page.

Title and text should be pre-processed. STUB

Parameters

int	$id
string	$title
string	$text

Reimplemented in SearchMssql, SearchMySQL, SearchOracle, SearchSqlite, MockSearch, and SearchPostgres.

Definition at line 381 of file SearchEngine.php.

◆ updateTitle()

SearchEngine::updateTitle	(		$id,
			$title )

Update a search index record's title only.

Title should be pre-processed. STUB

Parameters

int	$id
string	$title

Reimplemented in SearchMssql, SearchMySQL, SearchOracle, SearchPostgres, and SearchSqlite.

Definition at line 393 of file SearchEngine.php.

◆ userHighlightPrefs()

static SearchEngine::userHighlightPrefs ( )

static

Find snippet highlight settings for all users.

Returns: array Contextlines, contextchars

Definition at line 366 of file SearchEngine.php.

◆ userNamespaces()

static SearchEngine::userNamespaces ( $user )

static

Extract default namespaces to search from the given user's settings, returning a list of index numbers.

Deprecated: since 1.27; use SearchEngineConfig::userNamespaces()

Parameters

user $user

Returns: array

Definition at line 654 of file SearchEngine.php.

Member Data Documentation

◆ $features

array SearchEngine::$features = []

protected

Feature values.

Definition at line 55 of file SearchEngine.php.

◆ $limit

int SearchEngine::$limit = 10

protected

Definition at line 42 of file SearchEngine.php.

Referenced by SearchMySQL\limitResult().

◆ $namespaces

int [] null SearchEngine::$namespaces = [ NS_MAIN ]

Definition at line 39 of file SearchEngine.php.

Referenced by SearchMySQL\queryNamespaces(), SearchMssql\queryNamespaces(), SearchOracle\queryNamespaces(), SearchSqlite\queryNamespaces(), and SearchPostgres\searchQuery().

◆ $offset

int SearchEngine::$offset = 0

protected

Definition at line 45 of file SearchEngine.php.

Referenced by SearchMySQL\limitResult().

◆ $prefix

string SearchEngine::$prefix = ''

Definition at line 36 of file SearchEngine.php.

◆ $searchTerms

array string SearchEngine::$searchTerms = []

protected

Definition at line 48 of file SearchEngine.php.

◆ $showSuggestion

bool SearchEngine::$showSuggestion = true

protected

Definition at line 51 of file SearchEngine.php.

◆ $sort

SearchEngine::$sort = 'relevance'

private

Definition at line 52 of file SearchEngine.php.

◆ CHARS_ALL

const SearchEngine::CHARS_ALL = 1

@const int flag for legalSearchChars: includes all chars allowed in a search query

Definition at line 64 of file SearchEngine.php.

◆ CHARS_NO_SYNTAX

const SearchEngine::CHARS_NO_SYNTAX = 2

@const int flag for legalSearchChars: includes all chars allowed in a search term

Definition at line 67 of file SearchEngine.php.

◆ COMPLETION_PROFILE_TYPE

const SearchEngine::COMPLETION_PROFILE_TYPE = 'completionSearchProfile'

@const string profile type for completionSearch

Definition at line 58 of file SearchEngine.php.

◆ FT_QUERY_INDEP_PROFILE_TYPE

const SearchEngine::FT_QUERY_INDEP_PROFILE_TYPE = 'fulltextQueryIndepProfile'

@const string profile type for query independent ranking features

Definition at line 61 of file SearchEngine.php.

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

includes/search/SearchEngine.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Member Function Documentation

◆ augmentSearchResults()

◆ completionSearch()

◆ completionSearchBackend()

◆ completionSearchWithVariants()

◆ create()

◆ defaultNamespaces()

◆ defaultNearMatcher()

◆ defaultPrefixSearch()

◆ delete()

◆ extractTitles()

◆ getFeatureData()

◆ getNearMatch()

◆ getNearMatcher()

◆ getNearMatchResultSet()

◆ getProfiles()

◆ getSearchIndexFields()

◆ getSearchTypes()

◆ getSort()

◆ getTextFromContent()

◆ getValidSorts()

◆ legalSearchChars()

◆ makeSearchFieldMapping()

◆ namespacesAsText()

◆ normalizeNamespaces()

◆ normalizeText()

◆ parseNamespacePrefixes()

◆ processCompletionResults()

◆ replacePrefixes()

◆ searchableNamespaces()

◆ searchArchiveTitle()

◆ searchText()

◆ searchTitle()

◆ setFeatureData()

◆ setLimitOffset()

◆ setNamespaces()

◆ setShowSuggestion()

◆ setSort()

◆ simplePrefixSearch()

◆ supports()

◆ textAlreadyUpdatedForIndex()

◆ transformSearchTerm()

◆ update()

◆ updateTitle()

◆ userHighlightPrefs()

◆ userNamespaces()

Member Data Documentation

◆ $features

◆ $limit

◆ $namespaces

◆ $offset

◆ $prefix

◆ $searchTerms

◆ $showSuggestion

◆ $sort

◆ CHARS_ALL

◆ CHARS_NO_SYNTAX

◆ COMPLETION_PROFILE_TYPE

◆ FT_QUERY_INDEP_PROFILE_TYPE