File: D:/HostingSpaces/SBogers10/shop.komma.nl/vendor/teamtnt/laravel-scout-tntsearch-driver/README.md
# TNTSearch Driver for Laravel Scout - Laravel 5.3 - 6.0
[](#backers) [](#sponsors) [](https://packagist.org/packages/teamtnt/laravel-scout-tntsearch-driver)
[](LICENSE.md)
[](https://travis-ci.org/teamtnt/laravel-scout-tntsearch-driver)
[](https://scrutinizer-ci.com/g/teamtnt/laravel-scout-tntsearch-driver)
[](https://packagist.org/packages/teamtnt/laravel-scout-tntsearch-driver)
This package makes it easy to add full text search support to your models with Laravel 5.3/5.4/5.5/5.6/5.7.
## Support us on Open Collective
- [TNTSearch](https://opencollective.com/tntsearch)
## Contents
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [Credits](#credits)
- [License](#license)
## Installation
You can install the package via composer:
``` bash
composer require teamtnt/laravel-scout-tntsearch-driver
```
Add the service provider:
```php
// config/app.php
'providers' => [
// ...
TeamTNT\Scout\TNTSearchScoutServiceProvider::class,
],
```
Ensure you have Laravel Scout as a provider too otherwise you will get an "unresolvable dependency" error
```php
// config/app.php
'providers' => [
// ...
Laravel\Scout\ScoutServiceProvider::class,
],
```
Add `SCOUT_DRIVER=tntsearch` to your `.env` file
Then you should publish `scout.php` configuration file to your config directory
```bash
php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"
```
In your `config/scout.php` add:
```php
'tntsearch' => [
'storage' => storage_path(), //place where the index files will be stored
'fuzziness' => env('TNTSEARCH_FUZZINESS', false),
'fuzzy' => [
'prefix_length' => 2,
'max_expansions' => 50,
'distance' => 2
],
'asYouType' => false,
'searchBoolean' => env('TNTSEARCH_BOOLEAN', false),
],
```
To prevent your search indexes being commited to your project repository,
add the following line to your `.gitignore` file.
```/storage/*.index```
The `asYouType` option can be set per model basis, see the example below.
## Usage
After you have installed scout and the TNTSearch 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:
```php
<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
use Laravel\Scout\Searchable;
class Post extends Model
{
use Searchable;
public $asYouType = true;
/**
* Get the indexable data array for the model.
*
* @return array
*/
public function toSearchableArray()
{
$array = $this->toArray();
// Customize array...
return $array;
}
}
```
Then, sync the data with the search service like:
`php artisan scout:import App\\Post`
If you have a lot of records and want to speed it up you can run (note that with this you can no longer use model-relations in your `toSearchableArray()`):
`php artisan tntsearch:import App\\Post`
After that you can search your models with:
`Post::search('Bugs Bunny')->get();`
## Constraints
Additionally to `where()` statements as conditions, you're able to use Eloquent queries to constrain your search. This allows you to take relationships into account.
If you make use of this, the search command has to be called after all queries have been defined in your controller.
The `where()` statements you already know can be applied everywhere.
```php
namespace App\Http\Controllers;
use App\Post;
class PostController extends Controller
{
/**
* Display a listing of the resource.
*
* @return \Illuminate\Http\Response
*/
public function index(Request $request)
{
$post = new Post;
// filter out posts to which the given topic is assigned
if($request->topic) {
$post = $post->whereNotIn('id', function($query){
$query->select('assigned_to')->from('comments')->where('topic','=', request()->input('topic'));
});
}
// only posts from people that are no moderators
$post = $post->byRole('moderator','!=');
// when user is not admin filter out internal posts
if(!auth()->user()->hasRole('admin'))
{
$post= $post->where('internal_post', false);
}
if ($request->searchTerm) {
$constraints = $post; // not necessary but for better readability
$post = Department::search($request->searchTerm)->constrain($constraints);
}
$post->where('deleted', false);
$post->orderBy('updated_at', 'asc');
$paginator = $department->paginate(10);
$posts = $paginator->getCollection();
// return posts
}
}
```
## OrderBy
An `orderBy()` statement can now be applied to the search query similar to the `where()` statement.
When using constraints apply it after the constraints are added to the query, as seen in the above example.
## Sponsors
Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/tntsearch#sponsor)]
## Credits
- [Nenad Ticaric](https://github.com/nticaric)
- [Sasa Tokic](https://github.com/stokic)
- [All Contributors](../../contributors)
## Contributors
This project exists thanks to all the people who contribute.
<a href="../../graphs/contributors"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/contributors.svg?width=890" /></a>
## Backers
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/laravel-scout-tntsearch-driver#backer)]
<a href="https://opencollective.com/laravel-scout-tntsearch-driver#backers" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/backers.svg?width=890"></a>
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/laravel-scout-tntsearch-driver#sponsor)]
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/0/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/0/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/1/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/1/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/2/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/2/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/3/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/3/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/4/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/4/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/5/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/5/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/6/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/6/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/7/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/7/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/8/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/8/avatar.svg"></a>
<a href="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/9/website" target="_blank"><img src="https://opencollective.com/laravel-scout-tntsearch-driver/sponsor/9/avatar.svg"></a>
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.