Class yii\sphinx\MatchBuilder

All Classes | Properties | Methods | Constants

Inheritance	yii\sphinx\MatchBuilder » yii\base\BaseObject
Available since version	2.0.6

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

Public Properties

Hide inherited properties

Property	Type	Description	Defined By
$db	yii\sphinx\Connection	The Sphinx connection.	yii\sphinx\MatchBuilder

Protected Properties

Hide inherited properties

Property	Type	Description	Defined 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

Method	Description	Defined 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

Method	Description	Defined 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

Constant	Value	Description	Defined 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.