Download the PHP package archy-bold/eloquent-searchable without Composer

Eloquent Searchable

Add search functionality to Eloquent models in Laravel 5.

This package is a WIP and currently only supports very basic text search in the Java-based elasticsearch currently. I will probably add fallback search functionality in the future, but feel free to fork and add additional third-party search engines.

NOTE: This package is missing many features that means it's only useful for the most basic of searches. See the 'Issues' section for a list of known issues and functionality gaps. Improvements to come!

• Requirements
• Installation
• Setup Models
• Usage
• Dealing With Errors
• Issues

Requirements

PHP >= 5.4.0

This pakages uses traits which require PHP 5.4. Laravel 5 also requires PHP 5.4.

elasticsearch

The package currently only supports search through elasticsearch, so you'll need server access and to get that running before you can use this package. Download the elasticsearch server here.

Java is also required to use elasticsearch.

Installation

You can install the package through composer with the following command:

Next, run composer update from your command line to get the dependencies.

Then, update config/app.php and add an entry for the service provider.

To get the default config.php file you must run the following command:

Setup

To make one of your models searchable, you should set it up as follows:

Your model should implement SearchableModel and use SearchableTrait. You should also include a $searchable variable for configuration. Currently this only takes a columns argument. This should be an array of columns that should be indexed. You can also reference columns through relationships eg country.name.

NOTE: This only currently supports 1:1 or m:1 relationships. 1:m or m:m relationships are not currently supported.

Next add your model to the search.php config file.

Where the key is a unique name to identify the models in results.

This will allow you to search on models as follows:

Where the returned object is an EloquentCollection of the results.

NOTE: By default, none of your models will be indexed. They will be automatically indexed when created or updated. If you delete a model, it will be removed from the index too.

Usage

As well as searching on the model itself (See above), you can search on all searchable models too.

First get an instance of the search provider by getting it from the app layer:

Or use dependency injection on your controllers.

You then have access to an instance of a SearchProvider (in this case, always an ElasticSearchProvider). You can then call use the searchAll() function.

This returns an array of EloquentCollections, with each collection containing the results for the search on a different model. The array is indexed by the key you chose for the model in the search config.

Dealing With Errors

If you get the following exception:

Elasticsearch isn't running. You'll need to start up the server with bin/elasticsearch where the bin/ directory is wherever you installed your elasticsearch instance.

Issues

• Initial indexing - the only models to be indexed are those added after the package has been installed.
• Basic text search only - the package currently only supports very basic searching on text.
• Limited results - only a limited number of results (10) are currently returned and pagination isn't supported.
• Limited search engines - only elasticsearch is currently supported. You need server access and Java installed to use elasticsearch.