Класс yii\sphinx\MatchExpression

use yii\sphinx\Query;
use yii\sphinx\MatchExpression;

$rows = (new Query())
    ->match(new MatchExpression('@title :title', ['title' => 'Yii']))
    ->all();

use yii\sphinx\Query;
use yii\sphinx\MatchExpression;

$rows = (new Query())
    ->match(
        // produces '((@title "Yii") (@author "Paul")) | (@content "Sphinx")' :
        (new MatchExpression())
            ->match(['title' => 'Yii'])
            ->andMatch(['author' => 'Paul'])
            ->orMatch(['content' => 'Sphinx'])
    )
    ->all();

use yii\sphinx\Query;
use yii\sphinx\MatchExpression;

$rows = (new Query())
    ->match(
        // produces '@title "Yii" MAYBE "Sphinx"' :
        (new MatchExpression())->match([
            'maybe',
            'title',
            'Yii',
            'Sphinx',
        ])
    )
    ->all();

$rows = (new Query())
    ->match(
        // produces '@title "Yii"~10' :
        (new MatchExpression())->match([
            'proximity',
            'title',
            'Yii',
            10,
        ])
    )
    ->all();

public string|array|yii\db\Expression $match = null

public array $params = []

__construct() public method

Конструктор.

public void __construct ( $match = null, $params = [], $config = [] )
$match	string	Выражение MATCH
$params	array	Параметры выражения.
$config	array	Пара имя-значение, которые будут использованы для инициализации свойств объекта

addParams() public method

Добавляет дополнительные параметры для обработки в запросе.

См. также params().

public $this addParams ( $params )
$params	array	Список значений параметров выражения, индексированных по заменителям параметров. Например, [':name' => 'Dan', ':age' => 31].
return	$this	Объект выражения

andFilterMatch() public method (доступно с версии 2.0.7)

Добавляет дополнительное условие MATCH к существующему, но игнорирует пустые операнды.

Новое условие и существующее будут соединены с помощью оператора 'И' ('AND').

Этот метод похож на andMatch(). Основное отличие в том, что этот метод удаляет пустые операнды запроса. В результате этот метод лучше всего подходит для построения условий запроса на основе значений фильтров, вводимых пользователем.

См. также:

• filterMatch()
• orFilterMatch()

public $this andFilterMatch ( array $condition )
$condition	array	Новое условие MATCH. Обратитесь к match() для указания этого параметра.
return	$this	Объект запроса

andMatch() public method

Добавляет дополнительное условие MATCH к существующему.

Новое условие и существующее будут соединены с помощью оператора 'И' ('AND').

См. также:

• match()
• orMatch()

public $this andMatch ( $condition, $params = [] )
$condition	string|array|yii\db\Expression	Новое условие MATCH. Обратитесь к match() для указания этого параметра.
$params	array	Параметры (имя => значение) для обработки в запросе.
return	$this	Сам объект выражения

filterCondition() protected method (доступно с версии 2.0.7)

Удаляет пустые операнды из заданного условия запроса.

protected array filterCondition ( $condition )
$condition	array	Исходное условие
return	array	Условие с удаленными пустыми операндами.

filterMatch() public method (доступно с версии 2.0.7)

Устанавливает часть MATCH запроса, но игнорирует пустые операнды.

Этот метод похож на match(). Основное отличие заключается в том, что этот метод удаляет пустые операнды запроса. В результате он лучше всего подходит для построения условий запроса на основе значений фильтров, вводимых пользователем.

Следующий код демонстрирует разницу между этим методом и match():

// MATCH (@title :title)
$query->filterMatch(['name' => null, 'title' => 'foo']);
// MATCH (@title :title)
$query->match(['title' => 20]);
// MATCH (@name :name @title :title)
$query->match(['name' => null, 'age' => 20]);

Обратите внимание, что, в отличие от match(), вы не можете передавать параметры привязки в этот метод.

См. также:

• \yii\sphinx\where()
• andFilterMatch()
• orFilterMatch()

public $this filterMatch ( array $condition )
$condition	array	Условия, которые должны быть помещены в часть MATCH. Обратитесь к match() для указания этого параметра.
return	$this	Объект запроса

isEmpty() protected method (доступно с версии 2.0.7)

Возвращает значение, указывающее, является ли данное значение "пустым".

Значение считается "пустым", если выполняется одно из следующих условий:

• он является null,
• пустая строка (''),
• строка, содержащая только пробельные символы,
• или пустой массив.

protected boolean isEmpty ( $value )
$value	mixed
return	boolean	Если значение пустое

match() public method

Устанавливает выражение MATCH.

Метод требует параметр $condition, и необязательно параметр $params, указывающий значения для обработки в выражение.

Параметр $condition должен быть либо строкой (например, '@name "John"') либо массивом.

См. также:

• andMatch()
• orMatch()

public $this match ( $condition, $params = [] )
$condition	string|array|yii\db\Expression	Условия, которые должны быть помещены в выражение MATCH.
$params	array	Параметры (имя => значение) для обработки в запросе.
return	$this	Сам объект выражения

orFilterMatch() public method (доступно с версии 2.0.7)

Добавляет дополнительное условие MATCH к существующему, но игнорирует пустые операнды.

Новое условие и существующее будут соединены с помощью оператора 'ИЛИ' ('OR').

Этот метод похож на orMatch(). Основное отличие в том, что этот метод удаляет пустые операнды запроса. В результате он лучше всего подходит для построения условий запроса на основе значений фильтров, вводимых пользователем.

См. также:

• filterMatch()
• andFilterMatch()

public $this orFilterMatch ( array $condition )
$condition	array	Новое условие MATCH. Обратитесь к match() для указания этого параметра.
return	$this	Объект запроса

orMatch() public method

Добавляет дополнительное условие MATCH к существующему.

Новое условие и существующее будут соединены с помощью оператора 'ИЛИ' ('OR').

См. также:

• match()
• andMatch()

public $this orMatch ( $condition, $params = [] )
$condition	строка|массив|yii\db\Expression	Новое условие WHERE. Обратитесь к match() для информации о том, как указать этот параметр.
$params	массив	Параметры (имя => значение), которые будут обработаны в запросе.
return	$this	Сам объект выражения

params() public method

Устанавливает параметры для обработки в запросе.

См. также addParams().

public $this params ( $params )
$params	массив	Список значений параметров выражения, индексированных именами заполнитель параметров. Например, [':name' => 'Dan', ':age' => 31].
return	$this	Сам объект выражения