elegisandi/aws-elasticsearch-laravel

AWS Elasticsearch Service for Laravel/Lumen

aws-elasticsearch-laravel

AWS Elasticsearch Service for Laravel/Lumen, _(*1)

NOTE: This package only caters search, aggregation, and indexing transactions. Other than that, you can refer to elasticsearch's official documentation., _(*2)

Installation

composer require elegisandi/aws-elasticsearch-laravel

Laravel/Lumen Integration

• Add service provider to your config/app.php providers, _(*3)

  elegisandi\AWSElasticsearchService\ElasticSearchServiceProvider::class, _(*4)

• Add facade to your config/app.php aliases, _(*5)

  'ElasticSearch' => elegisandi\AWSElasticsearchService\Facades\ElasticSearch::class, _(*6)

• Set AWS credentials and Elasticsearch config in your .env file, _(*7)

  AWS_ACCESS_KEY_ID
  AWS_SECRET_ACCESS_KEY
  AWS_REGION
  
  ELASTICSEARCH_ENDPOINT
  ELASTICSEARCH_PORT
  ELASTICSEARCH_SHARDS
  ELASTICSEARCH_REPLICAS
  ELASTICSEARCH_DEFAULT_INDEX
  ELASTICSEARCH_DEFAULT_TYPE
  ELASTICSEARCH_DEFAULT_TIME_FILTER_FIELD

  When you are already using aws elasticsearch service, set, _(*8)

  AWS_ELASTICSEARCH_SERVICE=true

If you want to configure elasticsearch mappings, settings and/or default type and index, just run:, _(*9)

php artisan vendor:publish --provider=elegisandi\\AWSElasticsearchService\\ElasticSearchServiceProvider

For Lumen:, _(*10)

• Register service provider to your bootstrap/app.php, _(*11)

  $app->register(elegisandi\AWSElasticsearchService\ElasticSearchServiceProvider::class);, _(*12)

Basic Usage

Using Facade:, _(*13)

<?php

namespace App;

use ElasticSearch;

public function index() {
    extract(ElasticSearch::setSearchParams(request()));

    $clicks = [];
    $total = 0;

    if ($hits = ElasticSearch::search($query, $options, $date_range)) {
        $clicks = $hits['hits']['hits'];
        $total = $hits['hits']['total'];
    }
}

For Lumen:, _(*14)

<?php

namespace App;

public function index() {
    extract(app('elasticsearch')->setSearchParams(request()));

    $clicks = [];
    $total = 0;

    if ($hits = app('elasticsearch')->search($query, $options, $date_range)) {
        $clicks = $hits['hits']['hits'];
        $total = $hits['hits']['total'];
    }
}

Console Commands

• Create Index (creates the default index), _(*15)

  php artisan elasticsearch:create-index, _(*16)

  To reset existing index,, _(*17)

  php artisan elasticsearch:create-index --reset, _(*18)

• Update Index Mapping (updates the default index mapping), _(*19)

  php artisan elasticsearch:update-index-mapping, _(*20)

  Only supports new properties updates., _(*21)

Available Methods

• aggregations(array $aggs, array $query = [], array $options = [], $type, $index)

  $aggs : must follow the structure specified in elasticsearch docs., _(*22)

  $query : see search method $query argument, _(*23)

  $options : see search method $options argument, _(*24)

  returns Array, _(*25)

• search(array $query = [], array $options = [], array $range = [], $type, $index)

  $query : an array of key-value pair of any available properties, _(*26)

  $options : an array of key-value pair of the ff: from, size, sort, _(*27)

  $range : an array representation of range query., _(*28)

  returns Array, _(*29)

• count(array $query = [], array $range = [], $type, $index)

  a (syntactic sugar) method of search with zero hits result, _(*30)

  returns Int, _(*31)

• setSearchParams(Request $request, array $defaults = [], $type)

  an optional and conventional approach of setting search params via query string, _(*32)

  $request : an instance of \Illuminate\Http\Request, query variables in used:, _(*33)

  • range, see getDateRange method
  • start, a valid date string
  • end, a valid date string
  • sort, a mapping property
  • order, value is either desc or asc
  • size, total results to return (max of 10000)

  $defaults : an array of key-value pair of the ff: sort, order, size, _(*34)

  returns Array, _(*35)

• getDateRange($range, $format = null)

  $range : predefined date range values: today, yesterday, last-7-days, this-month, last-month, last-2-months, last-3-months, _(*36)

  $format must be a valid date format, default is null which will return a DateTime instance, _(*37)

  returns Array, _(*38)

• setAggregationDailyDateRanges($start, $end, $format = null)

  $format must be a valid date format, default is null which will return a DateTime instance, _(*39)

  returns Array, _(*40)

• defaultAggregationNames

  returns Array, _(*41)

• defaultIndex

  returns String, _(*42)

• defaultType

  returns String, _(*43)

• defaultTimeFilterField

  returns String, _(*44)

• setSearchQueryFilters(Collection $query, array $bool_clauses = [], $type = null)

  returns Array, _(*45)

• setBoolQueryClause(Collection $query, array $properties, $context, $occur, callable $callback = null)

  returns Array, _(*46)

• getMappingPropertiesByDataType(Collection $properties, $data_type)

  returns Array, _(*47)

• getMappingProperties($type = null)

  returns Collection, _(*48)

• indexDocument(array $body, $type = null, $index = null)

  returns Array, _(*49)

• getDocument($id, $type, $index)

  returns Array, _(*50)

• updateDocument(array $fields, $id, $type = null, $index = null)

  returns Array, _(*51)

• deleteDocument($id, $type = null, $index = null)

  returns Array, _(*52)

• getSettings($index = null)

  returns Array, _(*53)

• updateSettings(array $settings, $index)

  returns Array, _(*54)

• getMappings($index, $type)

  returns Array, _(*55)

• updateMappings(array $properties, $type, $index)

  returns Array, _(*56)

• createIndex(array $mappings, array $settings, $index)

• getIndex($index = null)

  returns Boolean, _(*57)

• deleteIndex($index)

  returns Array, _(*58)

NOTE: All methods of the elasticsearch client are now supported.

Limitations

• Supported data types in search method are:, _(*59)

  • keyword
  • text
  • array
  • integer
  • boolean
  • ip

Contributing

Open an issue first to discuss potential changes/additions., _(*60)

License

MIT, _(*61)