ulff/elasticsearch-php-client-bundle

A very simple bundle for integrating Symfony2.x/3.x with Elasticsearch-PHP 5.0

ElasticsearchPhpClientBundle

Setting up bundle

Version Matrix

You need to match your version of Elasticsearch to the appropriate version of this library., _(*1)

Step 1: Install bundle

Install bundle using composer:, _(*2)

php composer.phar require "ulff/elasticsearch-php-client-bundle:2.0"

Enable the bundle in AppKernel.php:, _(*3)

// app/AppKernel.php

public function registerBundles()
{
    $bundles = [
        // ...
        new Ulff\ElasticsearchPhpClientBundle\UlffElasticsearchPhpClientBundle(),
    ];

    // ...
}

Step 2: add bundle configuration

Add following configuration to config.yml:, _(*4)

# app/config/config.yml

ulff_elasticsearch_php_client:
    elastic_host: "localhost"
    elastic_port: "9200"

Replace values with proper ones., _(*5)

Usage

Client usage

Elasticsearch client is available as a service:, _(*6)

$client = $this->get('ulff_elasticsearch_php_client.client');

Create new index:

$indexParams = new IndexParams('index-name', 'type-name', 'id');
$indexParams->setBody(['someField' => 'some value']);
$response = $client->index($indexParams);

Returns IndexResponse object., _(*7)

Get document:

$getParams = new GetParams('index-name', 'type-name', 'id');
$response = $client->get($getParams);

Returns GetResponse object., _(*8)

Delete document:

$deleteParams = new DeleteParams('index-name', 'type-name', 'id');
$response = $client->delete($deleteParams);

Returns DeleteResponse object., _(*9)

Delete by query:

$deleteParams = new DeleteByQueryParams('index-name', 'type-name');
$deleteParams->setBody([
   'query' => [
       'match_all' => new \stdClass(),
   ]
]);
$response = $client->deleteByQuery($deleteParams);

Returns DeleteByQueryResponse object., _(*10)

Make search query:

$searchParams = new SearchParams('index-name', 'type-name');
$searchParams->setBody([
    'query' => [
        'match' => [
            'someField' => 'some value'
        ]
    ]
]);
$response = $client->search($searchParams);

Update document:

$updateParams = new UpdateParams('index-name', 'type-name', 'id');
$updateParams->setBody(['someField' => 'some value']);
$response = $client->update($updateParams);

Returns UpdateResponse object., _(*11)

Purger usage

Bundle offers a possibility to purge whole index (by deleting and recreating empty). This can be useful e.g. for testing purposes., _(*12)

There is a separate ulff_elasticsearch_php_client.purger service provided with the bundle. Following example shows how to purge index:, _(*13)

$purger = $this->get('ulff_elasticsearch_php_client.purger');
$purger->purgeIndex('index_name');

Full documentation:

This bundle is a client for: * Elasticsearch-PHP 5.0 * Elasticsearch-PHP 2.0, _(*14)

Follow the documentation there., _(*15)

License

This bundle is licensed under the MIT license. Please, see the complete license in the bundle LICENSE file., _(*16)