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 | public function __clone() |
||
30 | |||
31 | /** |
||
32 | * @return SearchQuery |
||
33 | */ |
||
34 | public function fork() |
||
39 | |||
40 | /** |
||
41 | * Установить имя индекса для поиска |
||
42 | * @param $index |
||
43 | * @return self $this |
||
44 | */ |
||
45 | public function setIndex($index) |
||
50 | |||
51 | /** |
||
52 | * Установить имя типа для поиска |
||
53 | * @param $type |
||
54 | * @return self $this |
||
55 | */ |
||
56 | public function setType($type) |
||
61 | |||
62 | |||
63 | /** |
||
64 | * Выводить перечисленные поля. |
||
65 | * (не обязательный метод, по-умолчанию, выводятся все) |
||
66 | * Методы select() и exclude() могут работать совместно. |
||
67 | * @param array $fields |
||
68 | * @return self $this; |
||
69 | * @example $query->select(['id', 'title', 'brand.id', 'brand.title']); |
||
70 | */ |
||
71 | public function select(array $fields) |
||
76 | |||
77 | |||
78 | /** |
||
79 | * Добавить в результаты вычисляемое поле, на скриптовом языке painless или groovy |
||
80 | * @param string $fieldName - имя поля в результатах (если такое поле уже есть в документе, то оно будет заменено) |
||
81 | * @param Script $script - скрипт |
||
82 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-script-fields.html |
||
83 | * @return self $this |
||
84 | */ |
||
85 | public function addScriptField($fieldName, Script $script) |
||
90 | |||
91 | |||
92 | /** |
||
93 | * Удалить из выборки поля. |
||
94 | * (не обязательный метод, по-умолчанию, выводятся все) |
||
95 | * Методы select() и exclude() могут работать совместно. |
||
96 | * @param array $fields |
||
97 | * @return self $this; |
||
98 | * @example $query->exclude(['anons', '*.anons']); |
||
99 | */ |
||
100 | public function exclude(array $fields) |
||
105 | |||
106 | |||
107 | /** |
||
108 | * Добавить фильтр в raw формате, если готовые методы фильтрации не подходят. |
||
109 | * Для удобства используй готовые методы фильтрации: where(), whereIn(), whereBetween(), whereMatch() |
||
110 | * whereLess() и другие методы where*() |
||
111 | * |
||
112 | * @param string $type - тип фильтрации (term|terms|match|range) |
||
113 | * @param $filter - фильтр |
||
114 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/query-dsl-terms-query.html |
||
115 | * @return self $this |
||
116 | */ |
||
117 | public function addFilter($type, $filter) |
||
125 | |||
126 | |||
127 | /** |
||
128 | * Создать фильтр. |
||
129 | * |
||
130 | * @param $field - поле по которому фильтруем (id, page.categoryId...) |
||
131 | * @example $query->where('channel')->equal(1)->where('page.categoryId')->in([10,12]); |
||
132 | * @return Where; |
||
|
|||
133 | */ |
||
134 | public function where($field) |
||
142 | |||
143 | |||
144 | /** |
||
145 | * Добавить в фильтр сложное условие с вычислениями, на скриптовом языке painless или groovy. |
||
146 | * Использование параметров рекомендуется, для увеличения производительности и эффективности компилирования скриптов. |
||
147 | * |
||
148 | * @param Script $script - скрипт |
||
149 | * @return self $this; |
||
150 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/query-dsl-script-query.html |
||
151 | * @link https://www.elastic.co/guide/en/elasticsearch/reference/5.0/modules-scripting-painless.html |
||
152 | */ |
||
153 | public function whereScript(Script $script) |
||
158 | |||
159 | |||
160 | /** |
||
161 | * Установить поле сортировки. |
||
162 | * Для сортировки по релевантности существует псевдополе _score (значение больше - релевантность лучше) |
||
163 | * @param $field - поле сортировки |
||
164 | * @param string $order - направление сортировки asc|desc |
||
165 | * @example $query->setOrderBy('_score', 'desc'); |
||
166 | * @return self $this |
||
167 | */ |
||
168 | public function setOrderBy($field, $order = 'asc') |
||
174 | |||
175 | /** |
||
176 | * Добавить поле сортировки. |
||
177 | * Для сортировки по релевантности существует псевдополе _score (значение больше - релевантность лучше) |
||
178 | * @param $field - поле сортировки |
||
179 | * @param string $order - направление сортировки asc|desc |
||
180 | * @example $query->addOrderBy('_score', 'desc'); |
||
181 | * @example $query->addOrderBy('seller.rating', 'desc'); |
||
182 | * @return self $this |
||
183 | */ |
||
184 | public function addOrderBy($field, $order = 'asc') |
||
194 | |||
195 | |||
196 | /** |
||
197 | * Установить лимиты выборки |
||
198 | * @param $limit - сколько строк выбирать |
||
199 | * @param int $offset - сколько строк пропустить |
||
200 | * @return self $this; |
||
201 | */ |
||
202 | public function limit($limit, $offset = 0) |
||
208 | |||
209 | /** |
||
210 | * Получить собранный запрос |
||
211 | * @return array |
||
212 | */ |
||
213 | public function getQuery() |
||
223 | |||
224 | protected function executeQuery(array $query) |
||
228 | } |
This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types.