PHPackages laravilt/query-builder - 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. [Database & ORM](/categories/database) 4. / 5. laravilt/query-builder ActiveLibrary[Database & ORM](/categories/database) laravilt/query-builder ====================== Complete query builder system with filters, sorting, search, and pagination. Build powerful, filterable data queries with support for multiple filter types, custom sorts, full-text search, and seamless Inertia.js integration. 1.0.1(6mo ago)0527↓91.5%2[1 PRs](https://github.com/laravilt/query-builder/pulls)2MITPHPPHP ^8.3|^8.4CI passing Since Dec 11Pushed 2mo agoCompare [ Source](https://github.com/laravilt/query-builder)[ Packagist](https://packagist.org/packages/laravilt/query-builder)[ GitHub Sponsors](https://github.com/fadymondy)[ RSS](/packages/laravilt-query-builder/feed)WikiDiscussions master Synced today READMEChangelog (2)Dependencies (16)Versions (5)Used By (2) [![QueryBuilder](./arts/screenshot.jpg)](./arts/screenshot.jpg) Laravilt Query Builder ====================== [](#laravilt-query-builder) [![Latest Stable Version](https://camo.githubusercontent.com/2a8fddb742d5142b3107d079cf749123d1ca9dff647ab753ab36612919274b85/68747470733a2f2f706f7365722e707567782e6f72672f6c61726176696c742f71756572792d6275696c6465722f76657273696f6e2e737667)](https://packagist.org/packages/laravilt/query-builder)[![License](https://camo.githubusercontent.com/1069ab9886a332178251ce375f00649845e6f31b9b8d61c45d975a2b2d7850e5/68747470733a2f2f706f7365722e707567782e6f72672f6c61726176696c742f71756572792d6275696c6465722f6c6963656e73652e737667)](https://packagist.org/packages/laravilt/query-builder)[![Downloads](https://camo.githubusercontent.com/0a5846b981fa4d37b0129c58d4281859a2f2043f63b8ba665fe128ac2857205f/68747470733a2f2f706f7365722e707567782e6f72672f6c61726176696c742f71756572792d6275696c6465722f642f746f74616c2e737667)](https://packagist.org/packages/laravilt/query-builder)[![Dependabot Updates](https://github.com/laravilt/query-builder/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/laravilt/query-builder/actions/workflows/dependabot/dependabot-updates)[![PHP Code Styling](https://github.com/laravilt/query-builder/actions/workflows/fix-php-code-styling.yml/badge.svg)](https://github.com/laravilt/query-builder/actions/workflows/fix-php-code-styling.yml)[![Tests](https://github.com/laravilt/query-builder/actions/workflows/tests.yml/badge.svg)](https://github.com/laravilt/query-builder/actions/workflows/tests.yml) Complete query builder system with filters, sorting, search, and pagination for Laravilt. Build powerful, filterable data queries with support for multiple filter types, custom sorts, full-text search, and seamless Inertia.js integration. Features -------- [](#features) - 🔍 **Advanced Filtering** - Multiple filter types (select, date, range, boolean) - ↕️ **Sorting** - Custom sort options with direction control - 🔎 **Search** - Full-text search across multiple columns - 📄 **Pagination** - Built-in pagination support - ⚡ **Inertia Integration** - Seamless Vue 3 integration - 🎯 **Eloquent Compatible** - Works with Laravel's query builder - 🔧 **Customizable** - Extensible filters and sorts Installation ------------ [](#installation) ``` composer require laravilt/query-builder ``` The package will automatically register its service provider. Quick Start ----------- [](#quick-start) ``` use Laravilt\QueryBuilder\QueryBuilder; use Laravilt\QueryBuilder\Filters\SelectFilter; use Laravilt\QueryBuilder\Filters\DateFilter; use Laravilt\QueryBuilder\Sort; $queryBuilder = new QueryBuilder(); $queryBuilder ->filters([ SelectFilter::make('status') ->options([ 'active' => 'Active', 'inactive' => 'Inactive', ]), DateFilter::make('created_at') ->label('Created Date'), ]) ->sorts([ Sort::make('name')->label('Name'), Sort::make('created_at')->label('Date'), ]) ->search('search query') ->sortBy('created_at', 'desc') ->perPage(25) ->apply(User::query()) ->paginate(); ``` Filter Types ------------ [](#filter-types) ### Select Filter [](#select-filter) ``` use Laravilt\QueryBuilder\Filters\SelectFilter; SelectFilter::make('status') ->label('Status') ->options([ 'active' => 'Active', 'inactive' => 'Inactive', 'pending' => 'Pending', ]) ->multiple(); // Allow multiple selections ``` ### Date Filter [](#date-filter) ``` use Laravilt\QueryBuilder\Filters\DateFilter; DateFilter::make('created_at') ->label('Created Date') ->between(); // Date range filter ``` ### Range Filter [](#range-filter) ``` use Laravilt\QueryBuilder\Filters\RangeFilter; RangeFilter::make('price') ->label('Price Range') ->min(0) ->max(1000); ``` ### Boolean Filter [](#boolean-filter) ``` use Laravilt\QueryBuilder\Filters\BooleanFilter; BooleanFilter::make('is_active') ->label('Active Only'); ``` Sorting ------- [](#sorting) ``` use Laravilt\QueryBuilder\Sort; Sort::make('name') ->label('Name') ->default(); // Set as default sort Sort::make('created_at') ->label('Date') ->desc(); // Default direction: desc ``` Search ------ [](#search) ``` $queryBuilder->search($request->get('search')); // Search across specific columns $queryBuilder->searchColumns(['name', 'email', 'phone']); ``` Pagination ---------- [](#pagination) ``` // Enable pagination (default) $queryBuilder->paginated(); // Set per page $queryBuilder->perPage(25); // Disable pagination $queryBuilder->paginated(false); ``` Applying to Eloquent Query -------------------------- [](#applying-to-eloquent-query) ``` $query = User::query(); $queryBuilder ->filters([...]) ->apply($query) ->paginate(); ``` Inertia Integration ------------------- [](#inertia-integration) ``` use App\QueryBuilders\UserQueryBuilder; use Inertia\Inertia; public function index(Request $request) { $queryBuilder = new UserQueryBuilder(); $users = $queryBuilder ->fromRequest($request) ->apply(User::query()) ->paginate(); return Inertia::render('Users/Index', [ 'users' => $users, 'queryBuilder' => $queryBuilder->toInertiaProps(), ]); } ``` Vue 3 Component --------------- [](#vue-3-component) ``` import { ref } from 'vue' import { router } from '@inertiajs/vue3' const props = defineProps({ users: Object, queryBuilder: Object }) const handleFilterUpdate = (filters) => { router.get('/users', { filters }, { preserveState: true }) } ``` Configuration ------------- [](#configuration) Publish the config file: ``` php artisan vendor:publish --tag="laravilt-query-builder-config" ``` Assets ------ [](#assets) Publish the plugin assets: ``` php artisan vendor:publish --tag="laravilt-query-builder-assets" ``` Testing ------- [](#testing) ``` composer test ``` Code Style ---------- [](#code-style) ``` composer format ``` Static Analysis --------------- [](#static-analysis) ``` composer analyse ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 43 — FairBetter than 89% of packages Maintenance76 Regular maintenance activity Popularity17 Limited adoption so far Community11 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 205d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/2147eb2fca7ab5f0124d0fafd88ba2d2a5dfa3a0036fb8872d1084b7cba29366?d=identicon)[fadymondy](/maintainers/fadymondy) --- Top Contributors [![fadymondy](https://avatars.githubusercontent.com/u/11937812?v=4)](https://github.com/fadymondy "fadymondy (10 commits)") --- Tags searchlaravelpaginationeloquentinertiaquery builderfilterssortingvuelaravilt ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/laravilt-query-builder/health.svg) ``` [![Health](https://phpackages.com/badges/laravilt-query-builder/health.svg)](https://phpackages.com/packages/laravilt-query-builder) ``` ### Alternatives [spatie/laravel-medialibrary Associate files with Eloquent models 6.1k43.2M632](/packages/spatie-laravel-medialibrary)[mongodb/laravel-mongodb A MongoDB based Eloquent model and Query builder for Laravel 7.1k8.4M96](/packages/mongodb-laravel-mongodb)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[yajra/laravel-oci8 Oracle DB driver for Laravel via OCI8 8793.2M25](/packages/yajra-laravel-oci8)[glushkovds/phpclickhouse-laravel Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel 2051.5M2](/packages/glushkovds-phpclickhouse-laravel)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.0k](/packages/simplestats-io-laravel-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)