Skip to content

DieZeeL/laravel-scout-sphinx

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel Scout Sphinx Driver

THIS IS MY PERSONAL VERSION FOR MY PROJECT! DESCRIPTION MAYBE UPDATED LATER

Build Status Latest Version on Packagist Software License

Introduction

This package offers advanced functionality for searching and filtering data using Sphinx search engine for Laravel Scout.

Installation

Composer

Use the following command to install package via composer

composer require constantable/laravel-scout-sphinx

Configuration

Publish the Scout configuration using the vendor:publish Artisan command.

php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"

This command will publish the scout.php configuration file to your config directory. Edit this file to set 'sphinxsearch' as a Scout driver:

'driver' => env('SCOUT_DRIVER', 'sphinxsearch'),

And add default Sphinx connection options

    'sphinxsearch' => [
        'host' => env('SPHINX_HOST', 'localhost'),
        'port' => env('SPHINX_PORT', '9306'),
        'socket' => env('SPHINX_SOCKET'),
        'charset' => env('SPHINX_CHARSET'),
    ],

Override these variables in your .env file if need

Usage

  • Add the Laravel\Scout\Searchable trait to the model you would like to make searchable.
  • Customize index name and searchable data for the model:
    public function searchableAs()
    {
        return 'posts_index';
    }
    
    public function toSearchableArray()
    {
        $array = $this->toArray();

        // Customize array...

        return $array;
    }

The basic search:

$orders = App\Order::search('Star Trek')->get();

Please refer to the Scout documentation for additional information. You can run more complex queries on index using callback, set the where clause, orderBy or paginate, for example:

$oorders = App\Order::search($keyword, function (SphinxQL $query) {
        return $query->groupBy('description');
    })            
    ->where('status', 1)
    ->orderBy('date', 'DESC')
    ->paginate(20);

Note: Changes on Sphinx indexes are only allowed for RT (Real Time) indexes. If you have ones and you need to update/delete records please define public $isRT = true; model's property.

Credits

License

Licensed under the MIT license

About

This driver adds full-text search functionality using Sphinx search engine

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%