Laravel Searchable
This package makes it easy to get structured search from a variety of sources. Here's an example where we search through some models. We already did some small preparation on the models themselves.
$searchResults = (new Search())
->registerModel(User::class, 'name')
->registerModel(BlogPost::class, 'title')
->search('john');
The search will be performed case insensitive. $searchResults now contains all User models that contain john in the name attribute and BlogPosts that contain 'john' in the title attribute.
In your view you can now loop over the search results:
<h1>Searchh1>
There are {{ $searchResults->count() }} results.
@foreach($searchResults->groupByType() as $type => $modelSearchResults)
<h2>{{ $type }}h2>
@foreach($modelSearchResults as $searchResult)
<ul>
<li><a href="{{ $searchResult->url }}">{{ $searchResult->title }}a>li>
ul>
@endforeach
@endforeach
In this example we used models, but you can easily add a search aspect for an external API, list of files or an array of values.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Installation
You can install the package via composer:
composer require spatie/laravel-searchable
Usage
Preparing your models
In order to search through models you'll have to let them implement the Searchable interface.
namespace Spatie\Searchable;
interface Searchable
{
public function getSearchResult(): SearchResult;
}
You'll only need to add a getSearchResult method to each searchable model that must return an instance of SearchResult. Here's how it could look like for a blog post model.
use Spatie\Searchable\Searchable;
use Spatie\Searchable\SearchResult;
class BlogPost extends Model implements Searchable
{
public function getSearchResult(): SearchResult
{
$url = route('blogPost.show', $this->slug);
return new \Spatie\Searchable\SearchResult(
$this,
$this->title,
$url
);
}
}
Searching models
With the models prepared you can search them like this:
$searchResults = (new Search())
->registerModel(User::class, 'name')
->search('john');
The search will be performed case insensitive. $searchResults now contains all User models that contain john in the name attribute.
You can also pass multiple attributes to search through:
// use multiple model attributes
$searchResults = (new Search())
->registerModel(User::class, 'first_name', 'last_name')
->search('john');
// or use an array of model attributes
$searchResults = (new Search())
->registerModel(User::class, ['first_name', 'last_name'])
->search('john');
To get fine grained control you can also use a callable. This way you can also search for exact matches, apply scopes, eager load relationships, or even filter your query like you would using the query builder.
$search = (new Search())
->registerModel(User::class, function(ModelSearchAspect $modelSearchAspect) {
$modelSearchAspect
->addSearchableAttribute('name') // return results for partial matches on usernames
->addExactSearchableAttribute('email') // only return results that exactly match the e-mail address
->active()
->has('posts')
->with('roles');
});
Creating custom search aspects
You are not limited to only registering basic models as search aspects. You can easily create your own, custom search aspects by extending the SearchAspect class.
Consider the following custom search aspect to search an external API:
class OrderSearchAspect extends SearchAspect
{
public function getResults(string $term): Collection
{
return OrderApi::searchOrders($term);
}
}
This is how you can use it:
$searchResults = (new Search())
->registerAspect(OrderSearchAspect::class)
->search('john');
Limiting aspect results
It is possible to limit the amount of results returned by each aspect by calling limitAspectResults prior to performing the search.
$searchResults = (new Search())
->registerAspect(BlogPostAspect::class)
->limitAspectResults(50)
->search('How To');
Rendering search results
Here's an example on rendering search results:
<h1>Searchh1>
There are {{ $searchResults->count() }} results.
@foreach($searchResults->groupByType() as $type => $modelSearchResults)
<h2>{{ $type }}h2>
@foreach($modelSearchResults as $searchResult)
<ul>
<a href="{{ $searchResult->url }}">{{ $searchResult->title }}a>
ul>
@endforeach
@endforeach
You can customize the $type by adding a public property $searchableType on your model or custom search aspect
class BlogPost extends Model implements Searchable
{
public $searchableType = 'custom named aspect';
}
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
6 Nov 2, 2022
354 Nov 16, 2022
1k Dec 27, 2022
844 Dec 25, 2022
318 Oct 21, 2022
2k Dec 27, 2022
592 Dec 25, 2022
215 Sep 8, 2022
62 Mar 14, 2022
30 Dec 29, 2022
94 Dec 14, 2022
126 Dec 7, 2022
18 Dec 21, 2022
93 Nov 13, 2022
1 Jan 20, 2022
4 Feb 18, 2022
2 Feb 24, 2022