gskema/elasticsearch-query-dsl-php

Feature complete, object oriented, composable, extendable ElasticSearch query DSL builder for PHP.

Elasticsearch Query DSL

![Software License][ico-license] ![Total Downloads][ico-downloads], _(*1)

Feature complete, object oriented, composable, extendable Elasticsearch query DSL builder for PHP., _(*2)

Features

• Dependency free
• Can be used with any PHP Elasticsearch client
• Fully interfaced, ready for custom classes and
• Explicit class and property naming, fully matches produced JSON and Elasticsearch docs
• All configuration options are listed inside classes, links to documentation
• Classes can be easily composed, extended
• Usage of setters/getters so that everything can be inlined and chained.
• Fully working ::__clone() methods
• Extendable code: no usage of private, final or readonly
• Basic objects created on __construct, no unnecessary body build logic until jsonSerialize() is called

Versions

Most of the classes should be compatible with any Elasticsearch versions. If something is not compatible or not supported, Raw* or custom classes can be used., _(*3)

Because major version number follows Elasticsearch major version number, second number is reserved for breaking changes., _(*4)

Install

``` bash composer require gskema/elasticsearch-query-dsl-php 6.* # match your Elasticsearch version, <sub>(*5)</sub>

## Usage

``` php
$searchRequest = new SearchRequest();
$searchRequest->setOption('min_score', 3.5);
$searchRequest->setSize(10);
$searchRequest->setQuery(
    (new BoolMatcher())->addMustNot(new TermMatcher('field1', 'value1'))
);
$searchRequest->addStatGroup('stat_group_1');
$searchRequest->setAgg(
    'agg1',
    (new FilterAggregation(new MatchAllMatcher()))
        ->setAgg('agg2', TermsAggregation::fromField('field2', 'value2'))
);

(new ElasticsearchClient())->search($searchRequest->jsonSerialize());

All classes match naming in official Elasticsearch documentation. Each class has a list of possible configuration options listed above class using attributes:, <sub>(*6)</sub>

#[Options([
    'flags' => 'ALL|ANYSTRING|COMPLEMENT|EMPTY|INTERSECTION|INTERVAL|NONE',
    'max_determinized_states' => 2000,
    ...
])]
class RegexpMatcher implements MultiTermMatcherInterface {}

Similarly, SearchRequest class also has possible URL parameters listed:, <sub>(*7)</sub>

#[Parameters([
    'timeout' => '2s',
    'terminate_after' => 1,
    'max_concurrent_shard_requests' => 2,
    ...
])]
class SearchRequest implements SearchRequestInterface {}

Matcher?

Request object that is received by Elasticsearch /_search/ has many properties and sub-properties like query, filter, post_filter, etc., <sub>(*8)</sub>

To avoid convoluted expressions like, <sub>(*9)</sub>

(new SearchRequest())->setQuery(
    (new BoolQuery()->addFilter(new TermQuery('x')
)->setPostFilter(new BoolQuery(...)))

keyword matcher was explicitly chosen., <sub>(*10)</sub>

Change log

Please see CHANGELOG for more information on what has changed recently., <sub>(*11)</sub>

Testing

bash ./vendor/bin/phpunit, <sub>(*12)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*13)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*14)</sub>