PHPackages laravelway/query-filters - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Search & Filtering](/categories/search) 4. / 5. laravelway/query-filters ActiveLibrary[Search & Filtering](/categories/search) laravelway/query-filters ======================== Laravel package for filtering models via query string 1.0.1(1y ago)01[4 PRs](https://github.com/laravelway/query-filters/pulls)MITPHPPHP ^8.3CI passing Since Jan 4Pushed 1mo ago1 watchersCompare [ Source](https://github.com/laravelway/query-filters)[ Packagist](https://packagist.org/packages/laravelway/query-filters)[ Docs](https://github.com/laravelway/query-filters)[ GitHub Sponsors]()[ RSS](/packages/laravelway-query-filters/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (15)Versions (7)Used By (0) Readme ====== [](#readme) This package can be used for filtering eloquent using query string. ``` // URL example: https://example.com?name=John&email=gmail.com ``` First you have to use `QueryFilters` trait in your model. ``` use LaravelWay\QueryFilters\Traits\QueryFilters; class User extends Model { use QueryFilters; } ``` Then you can use `addQueryFilters` scope on your model to add any filters you want. 1. Using array of filters ``` use LaravelWay\QueryFilters\Filters\EqualFilter; use LaravelWay\QueryFilters\Filters\ContainsFilter; User::query() ->addQueryFilters(filters: [ 'name' => EqualFilter::class, 'email' => ContainsFilter::class ]); ``` In this case it will filter by name parameter and email parameter from query string. 2. You can call `addQueryFilters` multiple times. It will merge all filters together. ``` use LaravelWay\QueryFilters\Filters\EqualFilter; use LaravelWay\QueryFilters\Filters\ContainsFilter; User::query() ->addQueryFilters(filters: [ 'name' => EqualFilter::class, ]) ->addQueryFilters(filters: [ 'email' => ContainsFilter::class, ]); ``` 3. You can use callbacks as filters. ``` User::query() ->addQueryFilters(filters: [ 'name' => function (Builder $builder, string $key, mixed $value, mixed $params = null) { $builder->where($key, $value); }, ]); ``` 4. You can use filters classes to define all filters there. In that case class must be extended from `FiltersAbstract` class. ``` use LaravelWay\QueryFilters\Filters\EqualFilter; use LaravelWay\QueryFilters\Filters\ContainsFilter; class UserFilters extends FiltersAbstract { /** @var array */ public array $filters = [ 'name' => EqualFilter::class, 'email' => ContainsFilter::class, ]; /** * @param Builder $builder */ public function filterSearch(Builder $builder, string $key, mixed $value, mixed $params = null): void { $builder->whereLike('name', "%$value%")->whereLike('email', "%$value%"); } } // and then you can use this class for filtering User::query()->addQueryFilters(filters: UserFilters::class); ``` As you can see, you can define standard filters in `$filters` property as array, or you can define custom functions which are prefixed with `filter` word. In our case `filterSearch` is using as filtering function, it means that it will filter by query parameter `search`. There are some standard filtering classes you can use for filtering. ### EqualFilter [](#equalfilter) it filters for exact value. ``` public array $filters = [ 'name' => EqualFilter::class, ]; // ?name=John - it will search all rows which are equals to John. // it can be case-insensitive if table column's collation ends with _ci suffix. ``` ### ContainsFilter [](#containsfilter) It filters rows which are contains that value in any part of string. ``` public array $filters = [ 'name' => ContainsFilter::class, ]; // ?name=John - it will search all rows which are contains John string. // it can be case-insensitive if table column's collation ends with _ci suffix. ``` ### ContainsInFilter [](#containsinfilter) This filter can be used if we need to filter for value can be found on multiple columns. Usually it used then user types something in one search input, but we must filter rows where that value can be found on one of the following columns. ``` public array $filters = [ 'search' => [ContainsInFilter::class, ['name', 'email', 'role']], ]; // ?search=John - it will search all rows which are contains John string in name, email or role columns. // it can be case-insensitive if table column's collation ends with _ci suffix. ``` ### LikeFilter [](#likefilter) This filter is similar to ContainsFilter, but contains will find in any part of string, but with like filter, you can specify in query string via \* which part of string sould contain a value. ``` public array $filters = [ 'name' => LikeFilter::class, ]; // ?name=John* - it will search all rows which are starting with John // ?name=*John - it will search all rows which are ending with John // it can be case-insensitive if table column's collation ends with _ci suffix. ``` ### TrashedFilter [](#trashedfilter) This filter is using to filter deleted rows if model uses SoftDeletes trait. ``` public array $filters = [ 'trashed' => TrashedFilter::class, ]; // ?trashed=with - it will search all rows even soft deleted rows // ?trashed=only - it will search only soft deleted rows ``` ### DateFilter [](#datefilter) This filter is using for filter dates. ``` public array $filters = [ 'trashed' => TrashedFilter::class, ]; // ?created_at=2024-03-01 - it will filter all rows which are created exactly at selected date // ?created_at=2024-03-01, - it will filter all rows where created_at field more or equal to selected date // ?created_at=,2024-03-01 - it will filter all rows where created_at field less or equal to selected date // ?created_at=2024-03-01,2024-03-16 - it will filter all rows where created_at field is between two selected dates including both dates ``` --- TODO ---- [](#todo) - test sorting - filter relations - sort relations - include relations into response ### Health Score 36 — LowBetter than 82% of packages Maintenance69 Regular maintenance activity Popularity1 Limited adoption so far Community10 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 497d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/85644385?v=4)[amanukian](/maintainers/amanukian)[@amanukian](https://github.com/amanukian) --- Top Contributors [![alikmanukian](https://avatars.githubusercontent.com/u/4147821?v=4)](https://github.com/alikmanukian "alikmanukian (6 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)") --- Tags laravelquery-filterslaravelway ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/laravelway-query-filters/health.svg) ``` [![Health](https://phpackages.com/badges/laravelway-query-filters/health.svg)](https://phpackages.com/packages/laravelway-query-filters) ``` ### Alternatives [spatie/laravel-site-search A site search engine 300129.1k](/packages/spatie-laravel-site-search)[vormkracht10/laravel-mails Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. 24149.7k](/packages/vormkracht10-laravel-mails)[codewithdennis/filament-price-filter A simple and customizable price filter for FilamentPHP, allowing users to easily refine results based on specified price ranges. 163.2k](/packages/codewithdennis-filament-price-filter)[eightynine/filament-docs Elegant documentation system for your Filament application with search, navigation, and markdown support 122.5k1](/packages/eightynine-filament-docs) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)