teamtnt / laravel-scout-tntsearch-driver
Driver for Laravel Scout search package based on https://github.com/teamtnt/tntsearch
Fund package maintenance!
teamtnt
Installs: 1 884 038
Dependents: 36
Suggesters: 0
Security: 0
Stars: 1 091
Watchers: 18
Forks: 143
Open Issues: 16
Requires
- php: >=7.1|^8
- illuminate/bus: ~5.4|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- illuminate/contracts: ~5.4|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- illuminate/pagination: ~5.4|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- illuminate/queue: ~5.4|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- illuminate/support: ~5.4|^6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- laravel/scout: 7.*|^8.0|^8.3|^9.0|^10
- teamtnt/tntsearch: 2.7.0|^2.8|^3.0|^4.0
Requires (Dev)
- mockery/mockery: ^1.0
- phpunit/phpunit: ^7.0|^8.0|^9.0|^10.5
Suggests
- teamtnt/tntsearch: Required to use the TNTSearch engine.
- v14.0.0
- v13.2.0
- v13.1.0
- v13.0.0
- v12.5.0
- v12.4.0
- v12.3.0
- v12.2.0
- v12.1.0
- v12.0.0
- v11.6.0
- v11.5.0
- v11.4.0
- v11.3.0
- v11.2.0
- v11.1.0
- v11.0.0
- v10.0.0
- v9.0.0
- v8.3.0
- v8.2.0
- v8.1.0
- v8.0.0
- v7.2.0
- v7.1.0
- v7.0.0
- v6.1
- v3.3.0
- v3.2.2
- v3.2.1
- v3.2.0
- v3.1.0
- v3.0.8
- v3.0.7
- v3.0.6
- v3.0.5
- v3.0.4
- v3.0.3
- v3.0.2
- v3.0.1
- v3.0.0
- v2.0.5
- v2.0.4
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0.0
- v1.1.6
- v1.1.5
- v1.1.4
- v1.1.3
- v1.1.2
- v1.1.1
- v1.1.0
- dev-master / 1.0.x-dev
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
- dev-analysis-86331W
- dev-analysis-8LmWkw
- dev-analysis-q1kD5w
- dev-analysis-qJD9xn
- dev-analysis-zY69Qj
- dev-analysis-8Pe7EL
- dev-analysis-z3GJ69
This package is auto-updated.
Last update: 2024-10-12 07:45:35 UTC
README
This package makes it easy to add full text search support to your models with Laravel 5.3 to 9.0.
Premium products
If you find TNT Search to be one of your valuable assets, take a look at one of our premium products
Support us on Open Collective
Contents
Installation
You can install the package via composer:
composer require teamtnt/laravel-scout-tntsearch-driver
Add the service provider:
// 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
// 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
php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"
In your config/scout.php
add:
'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, 'no_limit' => true ], 'asYouType' => false, 'searchBoolean' => env('TNTSEARCH_BOOLEAN', false), 'maxDocs' => env('TNTSEARCH_MAX_DOCS', 500), ],
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 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();
Scout status
php artisan scout:status
With this simple command you'll get a quick overview of your search indices.
Or you can pass a searchable model argument:
php artisan scout:status "App\Models\Post"
If your models are not in the default location app
or one of its subdirectories, you may set the modelPath
option
// config/scout.php 'tntsearch' => [ // ... 'modelPath' => 'models', ],
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.
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 = Post::search($request->searchTerm)->constrain($constraints); } $post->where('deleted', false); $post->orderBy('updated_at', 'asc'); $paginator = $post->paginate(10); $posts = $paginator->getCollection(); // return posts } }
Adding via Query
The searchable()
method will chunk the results of the query and add the records to your search index.
$post = Post::find(1); // You may also add record via collection... $post->searchable(); // OR $posts = Post::where('year', '>', '2018')->get(); // You may also add records via collections... $posts->searchable();
When using constraints apply it after the constraints are added to the query, as seen in the above example.
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]
Credits
Contributors
This project exists thanks to all the people who contribute.
Backers
Thank you to all our backers! 🙏 [Become a backer]