1 | <?php |
||
12 | class SearchQuery extends Query |
||
13 | { |
||
14 | /** |
||
15 | * Параметры запроса |
||
16 | * @var array |
||
17 | */ |
||
18 | protected $params = []; |
||
19 | |||
20 | /** |
||
21 | * @var Where |
||
22 | */ |
||
23 | protected $whereHelper; |
||
24 | |||
25 | |||
26 | function __clone() |
||
30 | |||
31 | |||
32 | /** |
||
33 | * Установить имя индекса для поиска |
||
34 | * @param $index |
||
35 | * @return self $this |
||
36 | */ |
||
37 | public function setIndex($index) |
||
42 | |||
43 | /** |
||
44 | * Установить имя типа для поиска |
||
45 | * @param $type |
||
46 | * @return self $this |
||
47 | */ |
||
48 | public function setType($type) |
||
53 | |||
54 | |||
55 | /** |
||
56 | * Выводить перечисленные поля. |
||
57 | * (не обязательный метод, по-умолчанию, выводятся все) |
||
58 | * Методы select() и exclude() могут работать совместно. |
||
59 | * @param array $fields |
||
60 | * @return self $this; |
||
61 | * @example $query->select(['id', 'title', 'brand.id', 'brand.title']); |
||
62 | */ |
||
63 | public function select(array $fields) |
||
68 | |||
69 | |||
70 | /** |
||
71 | * Добавить в результаты вычисляемое поле, на скриптовом языке painless или groovy |
||
72 | * @param string $fieldName - имя поля в результатах (если такое поле уже есть в документе, то оно будет заменено) |
||
73 | * @param Script $script - скрипт |
||
74 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-script-fields.html |
||
75 | * @return self $this |
||
76 | */ |
||
77 | public function addScriptField($fieldName, Script $script) |
||
82 | |||
83 | |||
84 | /** |
||
85 | * Удалить из выборки поля. |
||
86 | * (не обязательный метод, по-умолчанию, выводятся все) |
||
87 | * Методы select() и exclude() могут работать совместно. |
||
88 | * @param array $fields |
||
89 | * @return self $this; |
||
90 | * @example $query->exclude(['anons', '*.anons']); |
||
91 | */ |
||
92 | public function exclude(array $fields) |
||
97 | |||
98 | |||
99 | /** |
||
100 | * Добавить фильтр в raw формате, если готовые методы фильтрации не подходят. |
||
101 | * Для удобства используй готовые методы фильтрации: where(), whereIn(), whereBetween(), whereMatch() |
||
102 | * whereLess() и другие методы where*() |
||
103 | * |
||
104 | * @param string $type - тип фильтрации (term|terms|match|range) |
||
105 | * @param $filter - фильтр |
||
106 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/query-dsl-terms-query.html |
||
107 | * @return self $this |
||
108 | */ |
||
109 | public function addFilter($type, $filter) |
||
117 | |||
118 | |||
119 | /** |
||
120 | * Создать фильтр. |
||
121 | * |
||
122 | * @param $field - поле по которому фильтруем (id, page.categoryId...) |
||
123 | * @example $query->where('channel')->equal(1)->where('page.categoryId')->in([10,12]); |
||
124 | * @return Where; |
||
125 | */ |
||
126 | public function where($field) |
||
134 | |||
135 | |||
136 | /** |
||
137 | * Добавить в фильтр сложное условие с вычислениями, на скриптовом языке painless или groovy. |
||
138 | * Использование параметров рекомендуется, для увеличения производительности и эффективности компилирования скриптов. |
||
139 | * |
||
140 | * @param Script $script - скрипт |
||
141 | * @return self $this; |
||
142 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/query-dsl-script-query.html |
||
143 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/modules-scripting-painless.html |
||
144 | */ |
||
145 | public function whereScript(Script $script) |
||
150 | |||
151 | |||
152 | /** |
||
153 | * Установить поле сортировки. |
||
154 | * Для сортировки по релевантности существует псевдополе _score (значение больше - релевантность лучше) |
||
155 | * @param $field - поле сортировки |
||
156 | * @param string $order - направление сортировки asc|desc |
||
157 | * @example $query->setOrderBy('_score', 'desc'); |
||
158 | * @return self $this |
||
159 | */ |
||
160 | public function setOrderBy($field, $order = 'asc') |
||
166 | |||
167 | /** |
||
168 | * Добавить поле сортировки. |
||
169 | * Для сортировки по релевантности существует псевдополе _score (значение больше - релевантность лучше) |
||
170 | * @param $field - поле сортировки |
||
171 | * @param string $order - направление сортировки asc|desc |
||
172 | * @example $query->addOrderBy('_score', 'desc'); |
||
173 | * @example $query->addOrderBy('seller.rating', 'desc'); |
||
174 | * @return self $this |
||
175 | */ |
||
176 | public function addOrderBy($field, $order = 'asc') |
||
186 | |||
187 | |||
188 | /** |
||
189 | * Установить лимиты выборки |
||
190 | * @param $limit - сколько строк выбирать |
||
191 | * @param int $offset - сколько строк пропустить |
||
192 | * @return self $this; |
||
193 | */ |
||
194 | public function limit($limit, $offset = 0) |
||
200 | |||
201 | /** |
||
202 | * Получить собранный запрос |
||
203 | * @return array |
||
204 | */ |
||
205 | public function getQuery() |
||
215 | |||
216 | protected function executeQuery(array $query) |
||
220 | } |
Adding explicit visibility (
private
,protected
, orpublic
) is generally recommend to communicate to other developers how, and from where this method is intended to be used.