shift31 / laravel-elasticsearch by shift31

A Laravel Service Provider for the Elasticsearch API client
362,700
197
12
Package Data
Maintainer Username: shift31
Maintainer Contact: code@shift31.com (Shift 31 Consulting)
Package Create Date: 2013-10-27
Package Last Update: 2017-08-24
Home Page:
Language: PHP
License: Unknown
Last Refreshed: 2024-03-26 03:11:37
Package Statistics
Total Downloads: 362,700
Monthly Downloads: 256
Daily Downloads: 1
Total Stars: 197
Total Watchers: 12
Total Forks: 41
Total Open Issues: 3

Laravel Elasticsearch Service Provider (4.5.0)

Latest Stable Version Total Downloads Build Status Coverage Status License

This is a Laravel (4.2) Service Provider for the official Elasticsearch low-level client.

Version Matrix

Since there are breaking changes in Elasticsearch versions, your version of Elasticsearch must match the version of this library, which matches the version of the Elasticsearch low-level client.

|Shift31/laravel-elasticsearch| Elasticsearch | Laravel | | :---: | :---: | :---: | | 0.4| <= 0.90.* | 4.2 | | 1.0, 2.0| >= 1.0 | 4.x, 5.x | |4.0| <= 0.90.* | 4.2| |4.1| >= 1.0 <= 2.0 | 4.2| |4.2| >= 2.0 <= 5.0| 4.2| |4.5| >= 5.0| 4.2| |5.0| <= 0.90.* | 5.x| |5.1| >= 1.0 <= 2.0 | 5.x| |5.2| >= 2.0 <= 5.0| 5.x| |5.5| >= 5.0| 5.x|

Attention: Until we launch new versions please keep using old stable versions (which are created as a branch) and don't use dev-master branch!

Usage

  1. Run composer require shift31/laravel-elasticsearch:~4.5.0

  2. Publish config file

Laravel artisan command

$ php artisan config:publish shift31/laravel-elasticsearch 

You can always read config parameters with:

\Config::get('shift31::elasticsearch');

Note: The keys of this array should be named according the parameters supported by Elasticsearch\ClientBuilder.

  1. In the 'providers' array in app/config/app.php, add 'Shift31\LaravelElasticsearch\ElasticsearchServiceProvider'.

  2. Use the Es facade to access any method from the Elasticsearch\Client class, for example:

$searchParams['index'] = 'your_index';
$searchParams['size'] = 50;
$searchParams['body']['query']['query_string']['query'] = 'foofield:barstring';
$result = Es::search($searchParams);

Default Configuration

If you return an empty array in the config file, Service provider merges default config with custom config variables. For custom config file question please see this elastic search configuration page.

Default config file which is publishing by artisan command.

Contributing

Please see CONTRIBUTING.md.