This agnostic package is a lightweight wrapper on top of the Elasticsearch PHP client. Its main goal is to allow for easier structuring of queries and indices in your application. It does not want to hide or replace functionality of the Elasticsearch PHP client.
Installation of the latest version is easy via composer:
composer require madewithlove/elasticsearcher
Elasticsearch | Elasticsearcher |
---|---|
>= 2.0 | >= 0.4 |
>= 1.0, < 2.0 | 0.3 |
Structure queries inside a class for clearer oversight in your application.
class MoviesFrom2014Query extends AbstractQuery
{
public function setup()
{
$this->searchIn('movies', 'movies');
// Full notation
$body = [
'query' => [
'bool' => [
'filter' => [
'term' => ['year' => 2014]
]
]
]
];
$this->setBody($body);
// Short (dotted) notation
$this->set('query.bool.filter.term.year', 2014);
}
}
// Usage
$query = new MoviesFrom2014Query($this->getElasticSearcher());
$query->run();
Move re-occuring or complex fragments of your query or index to a separate class.
class MoviesFrom2014Query extends AbstractQuery
{
public function setup()
{
$this->searchIn('movies', 'movies');
$this->set('query.bool.filter', [new YearFilter(2014)]);
}
}
Perform actions on the response from Elasticsearch before the Query returns the results. It can be used for converting the Elasticsearch documents into models/entities from your ORM. Re-use it in multiple queries.
class MoviesFrom2014Query extends AbstractQuery
{
public function setup()
{
$this->searchIn('movies', 'movies');
$this->parseResultsWith(new MoviesResultParser());
$body = array(...);
$this->setBody($body);
}
}
// Usage
$query = new MoviesFrom2014Query($this->getElasticSearcher());
$result = $query->run();
foreach ($result->getResults() as $movie) {
var_dump($movie->title, $movie->id, $movie->year);
}
$searcher->indicesManager()->exists('listings');
$searcher->indicesManager()->existsType('suggestions', 'movies');
$searcher->indicesManager()->create('suggestions');
$searcher->indicesManager()->update('suggestions');
$searcher->indicesManager()->delete('suggestions');
$searcher->indicesManager()->deleteType('suggestions', 'movies');
$manager->index('suggestions', 'movies', $data);
$manager->bulkIndex('suggestions', 'movies', [$data, $data, $data]);
$manager->update('suggestions', 'movies', 123, ['name' => 'Fight Club 2014']);
$manager->updateOrIndex('suggestions', 'movies', 123, ['name' => 'Fight Club 2014']);
$manager->delete('suggestions', 'movies', 123);
$manager->exists('suggestions', 'movies', 123);
$manager->get('suggestions', 'movies', 123);
The package does not and will not try to implement everything from the Elasticsearch client. Access to the client is always possible.
$client = $searcher->getClient();
use ElasticSearcher\Environment;
use ElasticSearcher\ElasticSearcher;
$env = new Environment(
['hosts' => ['localhost:9200']]
);
$searcher = new ElasticSearcher($env);
More usage in the examples and documentation.