Class yii\sphinx\MatchBuilder

Inheritanceyii\sphinx\MatchBuilder » yii\base\BaseObject
Available since version2.0.6

MatchBuilder builds a MATCH SphinxQL expression based on the specification given as a yii\sphinx\MatchExpression object.

See also:

Public Properties

Hide inherited properties

PropertyTypeDescriptionDefined By
$db yii\sphinx\Connection The Sphinx connection. yii\sphinx\MatchBuilder

Protected Properties

Hide inherited properties

PropertyTypeDescriptionDefined By
$matchBuilders array Map of MATCH keywords to builder methods. yii\sphinx\MatchBuilder
$matchOperators array Map of MATCH operators. yii\sphinx\MatchBuilder

Public Methods

Hide inherited methods

MethodDescriptionDefined By
__construct() Constructor. yii\sphinx\MatchBuilder
build() Generates the MATCH expression from given yii\sphinx\MatchExpression object. yii\sphinx\MatchBuilder
buildAndMatch() Connects two or more MATCH expressions with the AND or OR operator yii\sphinx\MatchBuilder
buildHashMatch() Creates a MATCH based on column-value pairs. yii\sphinx\MatchBuilder
buildIgnoreMatch() Create ignored MATCH expressions yii\sphinx\MatchBuilder
buildMatch() Create MATCH expression. yii\sphinx\MatchBuilder
buildMultipleMatch() Create MAYBE, SENTENCE or PARAGRAPH expressions. yii\sphinx\MatchBuilder
buildProximityMatch() Create PROXIMITY expressions yii\sphinx\MatchBuilder
buildSimpleMatch() Creates an Match expressions like "column" operator value. yii\sphinx\MatchBuilder
buildZoneMatch() Create MATCH expressions for zones. yii\sphinx\MatchBuilder

Protected Methods

Hide inherited methods

MethodDescriptionDefined By
buildMatchColumn() Created column as string for expression of MATCH yii\sphinx\MatchBuilder
buildMatchValue() Create placeholder for expression of MATCH yii\sphinx\MatchBuilder
parseParams() Returns the actual MATCH expression by inserting parameter values into the corresponding placeholders. yii\sphinx\MatchBuilder

Constants

Hide inherited constants

ConstantValueDescriptionDefined By
PARAM_PREFIX ':mp' The prefix for automatically generated query binding parameters. yii\sphinx\MatchBuilder

Property Details

$db public property

The Sphinx connection.

public yii\sphinx\Connection $db null
$matchBuilders protected property

Map of MATCH keywords to builder methods. These methods are used by buildMatch() to build MATCH expression from array syntax.

protected array $matchBuilders = ['AND' => 'buildAndMatch''OR' => 'buildAndMatch''IGNORE' => 'buildIgnoreMatch''PROXIMITY' => 'buildProximityMatch''MAYBE' => 'buildMultipleMatch''SENTENCE' => 'buildMultipleMatch''PARAGRAPH' => 'buildMultipleMatch''ZONE' => 'buildZoneMatch''ZONESPAN' => 'buildZoneMatch']
$matchOperators protected property

Map of MATCH operators. These operators are used for replacement of verbose operators.

protected array $matchOperators = ['AND' => ' ''OR' => ' | ''NOT' => ' !''=' => ' ']

Method Details

__construct() public method

Constructor.

public void __construct ( $connection, $config = [] )
$connection yii\sphinx\Connection

The Sphinx connection.

$config array

Name-value pairs that will be used to initialize the object properties

build() public method

Generates the MATCH expression from given yii\sphinx\MatchExpression object.

public string build ( $match )
$match yii\sphinx\MatchExpression

The yii\sphinx\MatchExpression object from which the MATCH expression will be generated.

return string

Generated MATCH expression.

buildAndMatch() public method

Connects two or more MATCH expressions with the AND or OR operator

public string buildAndMatch ( $operator, $operands, &$params )
$operator string

The operator which is used for connecting the given operands

$operands array

The Match expressions to connect

$params array

The expression parameters to be populated

return string

The MATCH expression

buildHashMatch() public method

Creates a MATCH based on column-value pairs.

public string buildHashMatch ( $match, &$params )
$match array

The match condition

$params array

The expression parameters to be populated

return string

The MATCH expression

buildIgnoreMatch() public method

Create ignored MATCH expressions

public string buildIgnoreMatch ( $operator, $operands, &$params )
$operator string

The operator which is used for Create Match expressions

$operands array

The Match expressions

$params
return string

The MATCH expression

buildMatch() public method

Create MATCH expression.

public string buildMatch ( $match, &$params )
$match string|array

MATCH specification.

$params array

The expression parameters to be populated

return string

The MATCH expression

buildMatchColumn() protected method

Created column as string for expression of MATCH

protected string buildMatchColumn ( $column, $ignored false )
$column string

Column specification.

$ignored boolean

Whether column should be specified as 'ignored'.

return string

The column statement.

buildMatchValue() protected method

Create placeholder for expression of MATCH

protected string buildMatchValue ( $value, &$params )
$value string|array|\yii\db\Expression
$params array

The expression parameters to be populated

return string

The MATCH expression

buildMultipleMatch() public method

Create MAYBE, SENTENCE or PARAGRAPH expressions.

public string buildMultipleMatch ( $operator, $operands, &$params )
$operator string

The operator which is used for Create Match expressions

$operands array

The Match expressions

$params
return string

The MATCH expression

buildProximityMatch() public method

Create PROXIMITY expressions

public string buildProximityMatch ( $operator, $operands, &$params )
$operator string

The operator which is used for Create Match expressions

$operands array

The Match expressions

$params
return string

The MATCH expression

buildSimpleMatch() public method

Creates an Match expressions like "column" operator value.

public string buildSimpleMatch ( $operator, $operands, &$params )
$operator string

The operator to use. Anything could be used e.g. >, <=, etc.

$operands array

Contains two column names.

$params array

The expression parameters to be populated

return string

The MATCH expression

throws \yii\base\InvalidParamException

on invalid operands count.

buildZoneMatch() public method

Create MATCH expressions for zones.

public string buildZoneMatch ( $operator, $operands, &$params )
$operator string

The operator which is used for Create Match expressions

$operands array

The Match expressions

$params
return string

The MATCH expression

parseParams() protected method

Returns the actual MATCH expression by inserting parameter values into the corresponding placeholders.

protected string parseParams ( $expression, $params )
$expression string

The expression string which is needed to prepare.

$params array

The binding parameters for inserting.

return string

Parsed expression.