You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tom b2920ce775 Update README.md 10 years ago
src First release beta 10 years ago
tests Initial Commit 10 years ago
.gitignore Initial Commit 10 years ago
.travis.yml Initial Commit 10 years ago
README.md Update README.md 10 years ago
composer.json Initial Commit 10 years ago
phpunit.xml Initial Commit 10 years ago

README.md

Laravel 4+ Searchy - Searching Made Easy

Searchy is an easy-to-use Laravel 4+ package that makes running user driven searches on data in your models easy and effective. It requires no other software installed on your server (so a bit slower) but can be setup and ready to go in minutes.

Installation

Add the service provider to the providers array in Laravel's app/config/app.php file:

'TomLingham\Searchy\SearchyServiceProvider'

Add the Alias to the aliases array in Laravel's app/config/app.php file:

'Searchy' => 'TomLingham\Searchy\SearchBuilder'

Usage

To use Searchy, you can take advantage of magic methods.

If you are searching the name column/field of users in a users table you would, for example run:

$users = Searchy::users('name')->query('John Smith');

you can also write this as:

$users = Searchy::search('users')->query('John Smith');

These example both return a Laravel DB Query Builder Object, so you will need to chain get() to actually return the results in a usable object:

$users = Searchy::search('users')->query('John Smith')->get();

Configuration

You can publish the configuration file to override the settings by running php artisan config:publish tom-lingham/searchy

You can set the default driver to use for ssearches in the configuration file. Your options (At this stage) are: fuzzy, simple and levenshtein.

You can also override these methods using the following syntax when running a search:

Searchy::driver('fuzzy')->users('name')->query('Bat Man')->get();

Drivers

Searchy takes advantage of 'Drivers' to handle matching various conditions of the fields you specify.

Drivers are simply a specified group of 'Matchers' which match strings based on different conditions.

Currently there are only three drivers: Simple, Fuzzy and Levenshtein (Experimental).

Road Map

So, the intention is to (in the future):

  1. Remove Searchy's dependancy on Laravel
  2. Include more drivers for more advanced searching (Including file searching, indexing and more)
  3. Implement an AJAX friendly interface for searching models and implementing autosuggestion features on the front end
  4. Speed up search performance