Download the PHP package spatie/laravel-searchable without Composer
On this page you can find all versions of the php package spatie/laravel-searchable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download spatie/laravel-searchable
More information about spatie/laravel-searchable
Files in spatie/laravel-searchable
Package laravel-searchable
Short Description Pragmatically search through models and other sources
License MIT
Homepage https://github.com/spatie/laravel-searchable
Informations about the package laravel-searchable
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.
The search will be performed case insensitive. $searchResults
now contains all User
models that contain john
in the name
attribute and BlogPost
s that contain 'john' in the title
attribute.
In your view you can now loop over the search results:
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:
Usage
Preparing your models
In order to search through models you'll have to let them implement the Searchable
interface.
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.
Searching models
With the models prepared you can search them like this:
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:
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.
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:
This is how you can use it:
Limiting aspect results
It is possible to limit the amount of results returned by each aspect by calling limitAspectResults
prior to performing the search.
Rendering search results
Here's an example on rendering search results:
You can customize the $type
by adding a public property $searchableType
on your model or custom search aspect
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you've found a bug regarding security please mail [email protected] instead of using the issue tracker.
Credits
- Alex Vanderbist
- Freek Van der Herten
- All Contributors
License
The MIT License (MIT). Please see License File for more information.