⚠️ This project has moved to the official Typesense Github org: https://github.com/typesense/laravel-scout-typesense-driver.
It was adopted as the official Typesense PHP client on Dec 2021 and ongoing development will take place there.
Please upgrade to the `typesense/laravel-scout-typesense-driver` composer package to receive new updates.
# Laravel Scout Typesense Engine
Typesense engine for laravel/scout https://github.com/typesense/typesense .
This package makes it easy to add full text search support to your models with Laravel 7.* to 8.*.You can install the package via composer:
composer require devloopsnet/laravel-typesense
Add the service provider:
// config/app.php
'providers' => [
// ...
Devloops\LaravelTypesense\TypesenseServiceProvider::class,
],
Ensure you have Laravel Scout as a provider too otherwise you will get an "unresolvable dependency" error
// config/app.php
'providers' => [
// ...
Laravel\Scout\ScoutServiceProvider::class,
],
Add SCOUT_DRIVER=typesense
to your .env
file
Then you should publish scout.php
configuration file to your config directory
php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"
In your config/scout.php
add:
'typesense' => [
'api_key' => 'abcd',
'nodes' => [
[
'host' => 'localhost',
'port' => '8108',
'path' => '',
'protocol' => 'http',
],
],
'nearest_node' => [
'host' => 'localhost',
'port' => '8108',
'path' => '',
'protocol' => 'http',
],
'connection_timeout_seconds' => 2,
'healthcheck_interval_seconds' => 30,
'num_retries' => 3,
'retry_interval_seconds' => 1,
],
After you have installed scout and the Typesense driver, you need to add the
Searchable
trait to your models that you want to make searchable. Additionaly, define the fields you want to make searchable by defining the toSearchableArray
method on the model and implement TypesenseSearch
:
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
use Devloops\LaravelTypesense\Interfaces\TypesenseSearch;
use Laravel\Scout\Searchable;
class Post extends Model implements TypesenseSearch
{
use Searchable;
/**
* Get the indexable data array for the model.
*
* @return array
*/
public function toSearchableArray()
{
$array = $this->toArray();
// Customize array...
return $array;
}
public function getCollectionSchema(): array {
return [
'name' => $this->searchableAs(),
'fields' => [
[
'name' => 'title',
'type' => 'string',
],
[
'name' => 'created_at',
'type' => 'int32',
],
],
'default_sorting_field' => 'created_at',
];
}
public function typesenseQueryBy(): array {
return [
'name',
];
}
}
Then, sync the data with the search service like:
php artisan scout:import App\\Post
After that you can search your models with:
$search = Post::search('Bugs Bunny');
$search = Post::search('Bugs Bunny',function (\Laravel\Scout\Builder $builder,\Typesense\Documents $documents, string $query, array $params){
return $documents->search($params);
});
Then you can apply your where(s) to the builder as follows :
//This way the default operator := will be used
$search->where('created_at', now()->unix());
//Or specially for typesense engine you can add typesense operator to the where statement
$search->where('created_at', [
'>=',
now()->unix()
]);
*Note : For geolocation search, make sure to send an empty operator as follows
$search->where('location', [
'',
[
48.86093481609114,
2.33698396872901
]
]);
Check Typesense Search for reference.
- Group by
$search->groupBy(['name', 'created_at'])
//or
$search->groupBy('name', 'created_at')
- Order
$search->orderBy('name','desc')
- Location Order
$search->orderByLocation('location',48.853, 2.344, 'desc')
//or
$search->orderByLocation('location',48.853, 2.344, 'asc')
- Group by limit
$search->groupByLimit(200)
- Highlight start tag
$search->setHighlightStartTag('<strong>')
- Highlight end tag
$search->setHighlightEndTag('<end>')
- Hits limit
$search->limitHits(200)
The searchable()
method will chunk the results of the query and add the records to your search index.
$post = Post::find(1);
$post->searchable();
$posts = Post::where('year', '>', '2018')->get();
You may also add records via collections...
$posts->searchable();
The MIT License (MIT). Please see License File for more information.