Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ongr-io/ElasticsearchDSL
Query DSL library for Elasticsearch
https://github.com/ongr-io/ElasticsearchDSL
dsl elasticsearch elasticsearch-php elasticsearch-queries php php-library standalone
Last synced: 13 days ago
JSON representation
Query DSL library for Elasticsearch
- Host: GitHub
- URL: https://github.com/ongr-io/ElasticsearchDSL
- Owner: ongr-io
- License: mit
- Created: 2015-06-25T08:27:27.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-08-10T14:20:05.000Z (3 months ago)
- Last Synced: 2024-10-29T18:47:22.421Z (18 days ago)
- Topics: dsl, elasticsearch, elasticsearch-php, elasticsearch-queries, php, php-library, standalone
- Language: PHP
- Homepage:
- Size: 1.07 MB
- Stars: 459
- Watchers: 27
- Forks: 199
- Open Issues: 56
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ElasticsearchDSL
Introducing Elasticsearch DSL library to provide objective query builder for [Elasticsearch bundle](https://github.com/ongr-io/ElasticsearchBundle) and [elasticsearch-php](https://github.com/elastic/elasticsearch-php) client. You can easily build any Elasticsearch query and transform it to an array.
If you need any help, [stack overflow](http://stackoverflow.com/questions/tagged/ongr)
is the preferred and recommended way to ask ONGR support questions.
[](https://travis-ci.org/ongr-io/ElasticsearchDSL)
[](https://codecov.io/gh/ongr-io/ElasticsearchDSL)
[](https://packagist.org/packages/ongr/elasticsearch-dsl)
[](https://packagist.org/packages/ongr/elasticsearch-dsl)
[](https://scrutinizer-ci.com/g/ongr-io/ElasticsearchDSL/?branch=master)
If you like this library, help me to develop it by buying a cup of coffee
## Version matrix
| Elasticsearch version | ElasticsearchDSL version |
| --------------------- | --------------------------- |
| >= 7.0 | >= 7.0 |
| >= 6.0, < 7.0 | >= 6.0 |
| >= 5.0, < 6.0 | >= 5.0 |
| >= 2.0, < 5.0 | >= 2.0 (not supported) |
| >= 1.0, < 2.0 | 1.x (not supported) |
| <= 0.90.x | not supported |
## Documentation
[The online documentation of the bundle is here](docs/index.md)
## Try it!
### Installation
Install library with [composer](https://getcomposer.org):
```bash
$ composer require ongr/elasticsearch-dsl
```
> [elasticsearch-php](https://github.com/elastic/elasticsearch-php) client is defined in the composer requirements, no need to install it.
### Search
Elasticsearch DSL was extracted from [Elasticsearch Bundle](https://github.com/ongr-io/ElasticsearchBundle) to provide standalone query dsl for [elasticsearch-php](https://github.com/elastic/elasticsearch-php). Examples how to use it together with [Elasticsearch Bundle](https://github.com/ongr-io/ElasticsearchBundle) can be found in the [Elasticsearch Bundle docs](https://github.com/ongr-io/ElasticsearchBundle/blob/master/Resources/doc/search.md).
If you dont want to use Symfony or Elasticsearch bundle, no worries, you can use it in any project together with [elasticsearch-php](https://github.com/elastic/elasticsearch-php). Here's the example:
If you are using Symfony there is also the [ElasticsearchBundle](https://github.com/ongr-io/ElasticsearchBundle)
which provides full integration with Elasticsearch DSL.
The library is standalone and is not coupled with any framework. You can use it in any PHP project, the only
requirement is composer. Here's the example:
Create search:
```php
build(); //elasticsearch-php client
$matchAll = new ONGR\ElasticsearchDSL\Query\MatchAllQuery();
$search = new ONGR\ElasticsearchDSL\Search();
$search->addQuery($matchAll);
$params = [
'index' => 'your_index',
'body' => $search->toArray(),
];
$results = $client->search($params);
```
Elasticsearch DSL covers every elasticsearch query, all examples can be found in [the documentation](docs/index.md)