Download the PHP package aloko/elasticquent5 without Composer

On this page you can find all versions of the php package aloko/elasticquent5. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package elasticquent5

Elasticquent - Laravel 5

Elasticsearch for Eloquent Laravel 5 Models

Note: Aloko\Elasticquent5 is a built on top of adamfairholm/Elasticquent which was built for Laravel 4.x. As the author of that package, didn't merge the pull requests for changes to be compatible with Laravel 5. I decided to publish this one.

Elasticquent makes working with Elasticsearch and Eloquent models easier by mapping them to Elasticsearch types. You can use the default settings or define how Elasticsearch should index and search your Eloquent models right in the model.

Elasticquent uses the official Elasticsearch PHP API. To get started, you should have a basic knowledge of how Elasticsearch works (indexes, types, mappings, etc). This is meant for use with Elasticsearch 1.x.

Contents

Overview

Elasticquent allows you take an Eloquent model and easily index and search its contents in Elasticsearch.

$books = Book::where('id', '<', 200)->get();
$books->addToIndex();

When you search, instead of getting a plain array of search results, you instead get an Eloquent collection with some special Elasticsearch functionality.

$books = Book::search('Moby Dick')->get();
echo $books->totalHits();

Plus, you can still use all the Eloquent collection functionality:

$books = $books->filter(function($book)
{
    return $book->hasISBN();
});

Check out the rest of the documentation for how to get started using Elasticsearch and Elasticquent!

How Elasticquent Works

When using a database, Eloquent models are populated from data read from a database table. With Elasticquent, models are populated by data indexed in Elasticsearch. The whole idea behind using Elasticsearch for search is that its fast and light, so you model functionality will be dictated by what data has been indexed for your document.

Setup

Before you start using Elasticquent, make sure you've installed Elasticsearch.

Step 1 - Installation

composer require aloko/elasticquent5

Step 2 - Adding the Service Provider

Add the following line into your config/app.php file's providers array:

Aloko\Elasticquent\ElasticquentServiceProvider::class

Step 3 - Publishing the Config File

From your command line, enter this line:

php artisan vendor:publish --provider="Aloko\Elasticquent\ElasticquentServiceProvider" --tag="config"

This file will contain different configurations for your Elasticsearch instance (e.g. hosts, log files, default index, etc), file will reside in your config/elasticquent.php. You can change it for your preferred ones.

Final Step - Adding it to models

Now your Eloquent model has some extra methods that make it easier to index your model's data using Elasticsearch.

Next Steps

Indexes and Mapping

While you can definitely build your indexes and mapping through the Elasticsearch API, you can also use some helper methods to build indexes and types right from your models.

If you want a simple way to create indexes, Elasticquent models have a function for that:

Book::createIndex($shards = null, $replicas = null);

For mapping, you can set a mappingProperties property in your model and use some mapping functions from there:

If you'd like to setup a model's type mapping based on your mapping properties, you can use:

Book::putMapping($ignoreConflicts = true);

To delete a mapping:

Book::deleteMapping();

To rebuild (delete and re-add, useful when you make important changes to your mapping) a mapping:

Book::rebuildMapping();

You can also get the type mapping and check if it exists.

Book::mappingExists();
Book::getMapping();

Setting a Custom Index Name

Elastiquent will use default as your index name, but you can set a custom index name by editing config/elasticquent.php config file::

Setting a Custom Type Name

By default, Elasticquent will use the table name of your models as the type name for indexing. If you'd like to override it, you can with the getTypeName function. Add this function into your models (e.g. Book).

To check if the type for the Elasticquent model exists yet, use typeExists:

$typeExists = Book::typeExists();

Indexing Documents

To index all the entries in an Eloquent model, use addAllToIndex:

Book::addAllToIndex();

You can also index a collection of models:

$books = Book::where('id', '<', 200)->get();
$books->addToIndex();

You can index individual entries as well:

$book = Book::find($id);
$book->addToIndex();

You can also reindex an entire model:

Book::reindex();

Searching

There are two ways to search in Elasticquent. The first is a simple term search that searches all fields.

$books = Book::search('Moby Dick');

The second is a query based search for more complex searching needs:

$books = Book::searchByQuery(array('match' => array('title' => 'Moby Dick')));

Both methods will return a search collection.

Here's the list of available paramers:

Search Collections

When you search on an Elasticquent model, you get a search collection with some special functions.

You can get total hits:

$books->totalHits();

Access the shards array:

$books->shards();

Access the max score:

$books->maxScore();

Access the timed out boolean property:

$books->timedOut();

And access the took property:

$books->took();

And access search aggregations - See Aggregations for details:

$books->getAggregations();

Search Collection Documents

Items in a search result collection will have some extra data that comes from Elasticsearch. You can always check and see if a model is a document or not by using the isDocument function:

$book->isDocument();

You can check the document score that Elasticsearch assigned to this document with:

$book->documentScore();

Using the Search Collection Outside of Elasticquent

If you're dealing with raw search data from outside of Elasticquent, you can use the Elasticquent search results collection to turn that data into a collection.

More Options

Document IDs

Elasticquent will use whatever is set as the primaryKey for your Eloquent models as the id for your Elasticsearch documents.

Document Data

By default, Elasticquent will use the entire attribute array for your Elasticsearch documents. However, if you want to customize how your search documents are structured, you can set a getIndexDocumentData function that returns you own custom document array.

Be careful with this, as Elasticquent reads the document source into the Eloquent model attributes when creating a search result collection, so make sure you are indexing enough data for your the model functionality you want to use.

Using Elasticquent With Custom Collections

If you are using a custom collection with your Eloquent models, you just need to add the ElasticquentCollectionTrait to your collection so you can use addToIndex.

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


All versions of elasticquent5 with dependencies

PHP Build Version
Package Version
Requires php Version >=5.5.9
illuminate/support Version ~5.0
elasticsearch/elasticsearch Version ~1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package aloko/elasticquent5 contains the following files

Loading the files please wait ....