MultiMatch query type

- you can search in multified mapping type
- with configurable match type

Author: Spamercz

src/Query/Match/MultiMatchType.php

@@ -0,0 +1,26 @@
+<?php declare(strict_types = 1);
+
+namespace Spameri\ElasticQuery\Query\Match;
+
+
+class MultiMatchType
+{
+
+	public const BEST_FIELDS 	= 'best_fields';
+	public const MOST_FIELDS 	= 'most_fields';
+	public const CROSS_FIELDS 	= 'cross_fields';
+	public const PHRASE 		= 'phrase';
+	public const PHRASE_PREFIX 	= 'phrase_prefix';
+	public const BOOL_PREFIX 	= 'bool_prefix';
+
+
+	public const TYPES = [
+		self::BEST_FIELDS 	=> self::BEST_FIELDS,
+		self::MOST_FIELDS 	=> self::MOST_FIELDS,
+		self::CROSS_FIELDS 	=> self::CROSS_FIELDS,
+		self::PHRASE 		=> self::PHRASE,
+		self::PHRASE_PREFIX => self::PHRASE_PREFIX,
+		self::BOOL_PREFIX 	=> self::BOOL_PREFIX,
+	];
+
+}

src/Query/MultiMatch.php

@@ -0,0 +1,122 @@
+<?php declare(strict_types = 1);
+
+namespace Spameri\ElasticQuery\Query;
+
+
+/**
+ * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-multi-match-query.html
+ */
+class MultiMatch implements LeafQueryInterface
+{
+
+	/**
+	 * @var string
+	 */
+	private $fields;
+
+	/**
+	 * @var string
+	 */
+	private $query;
+
+	/**
+	 * @var string
+	 */
+	private $type;
+
+	/**
+	 * @var string
+	 */
+	private $operator;
+
+	/**
+	 * @var null|\Spameri\ElasticQuery\Query\Match\Fuzziness
+	 */
+	private $fuzziness;
+
+	/**
+	 * @var float
+	 */
+	private $boost;
+
+	/**
+	 * @var null|string
+	 */
+	private $analyzer;
+
+	/**
+	 * @var int|null
+	 */
+	private $minimumShouldMatch;
+
+
+	public function __construct(
+		array $fields
+		, $query
+		, float $boost = 1.0
+		, string $type = \Spameri\ElasticQuery\Query\Match\MultiMatchType::BEST_FIELDS
+		, string $operator = \Spameri\ElasticQuery\Query\Match\Operator::OR
+		, ?\Spameri\ElasticQuery\Query\Match\Fuzziness $fuzziness = NULL
+		, ?string $analyzer = NULL
+		, ?int $minimumShouldMatch = NULL
+	)
+	{
+		if ( ! \in_array($operator, \Spameri\ElasticQuery\Query\Match\Operator::OPERATORS, TRUE)) {
+			throw new \Spameri\ElasticQuery\Exception\InvalidArgumentException(
+				'Parameter $operator is invalid, see \Spameri\ElasticQuery\Query\Match\Operator::OPERATORS for valid arguments.'
+			);
+		}
+		if ( ! \in_array($type, \Spameri\ElasticQuery\Query\Match\MultiMatchType::TYPES, TRUE)) {
+			throw new \Spameri\ElasticQuery\Exception\InvalidArgumentException(
+				'Parameter $type is invalid, see \Spameri\ElasticQuery\Query\Match\MultiMatchType::TYPES for valid arguments.'
+			);
+		}
+
+		$this->fields = $fields;
+		$this->query = $query;
+		$this->type = $type;
+		$this->operator = $operator;
+		$this->fuzziness = $fuzziness;
+		$this->boost = $boost;
+		$this->analyzer = $analyzer;
+		$this->minimumShouldMatch = $minimumShouldMatch;
+	}
+
+
+	public function key() : string
+	{
+		return 'multiMatch_' . \implode('-', $this->fields) . '_' . $this->query;
+	}
+
+
+	public function toArray() : array
+	{
+		$array = [
+			'multi_match' => [
+				'query' => $this->query,
+				'type' => $this->type,
+				'fields' => $this->fields,
+				'boost' => $this->boost,
+			],
+		];
+
+		if ($this->operator) {
+			$array['multi_match']['operator'] = $this->operator;
+		}
+
+		if ($this->fuzziness && $this->fuzziness->__toString()) {
+			$array['multi_match']['fuzziness'] = $this->fuzziness->__toString();
+		}
+
+		if ($this->analyzer) {
+			$array['multi_match']['analyzer'] = $this->analyzer;
+		}
+
+		if ($this->minimumShouldMatch) {
+			$array['multi_match']['minimum_should_match'] = $this->minimumShouldMatch;
+		}
+
+		return $array;
+	}
+
+}