PHPackages accelade/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. accelade/query-builder ActiveLibrary[Database & ORM](/categories/database) accelade/query-builder ====================== Query builder engine for Accelade - build, filter, sort, and paginate Eloquent queries with a fluent API v1.0.0(3mo ago)0318[1 PRs](https://github.com/accelade/query-builder/pulls)3MITPHPPHP ^8.2CI failing Since Jan 19Pushed 1mo agoCompare [ Source](https://github.com/accelade/query-builder)[ Packagist](https://packagist.org/packages/accelade/query-builder)[ Docs](https://github.com/accelade/query-builder)[ GitHub Sponsors](https://github.com/fadymondy)[ RSS](/packages/accelade-query-builder/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (7)Versions (4)Used By (3) Accelade Query Builder ====================== [](#accelade-query-builder) [![Tests](https://github.com/accelade/query-builder/actions/workflows/tests.yml/badge.svg)](https://github.com/accelade/query-builder/actions/workflows/tests.yml)[![Latest Version](https://camo.githubusercontent.com/d35f14185a1826a675291e658b0e5dd45111669cda212e4cb6bca756083129ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616363656c6164652f71756572792d6275696c6465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/accelade/query-builder)[![License](https://camo.githubusercontent.com/88a9a8ae006d6fb01ff31e0e5ee8018360573ffd398445c8b354ac297dae5408/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616363656c6164652f71756572792d6275696c6465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/accelade/query-builder) A fluent query builder for Laravel applications built with Accelade. Build, filter, sort, and paginate Eloquent queries with a clean, expressive API. Features -------- [](#features) - **Search** - Global search across multiple columns with relationship support - **Filters** - Exact, partial, scope, and custom filters - **Sorting** - Sortable columns with ascending/descending support - **Pagination** - Standard, simple, and cursor pagination - **Request Binding** - Automatically apply search, sort, and filters from HTTP request - **Relationship Support** - Search and filter through related models Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11.0+ or 12.0+ - Accelade ^1.0 Installation ------------ [](#installation) ``` composer require accelade/query-builder ``` Quick Start ----------- [](#quick-start) ``` use Accelade\QueryBuilder\QueryBuilder; use App\Models\User; // Create a query builder from a model $users = QueryBuilder::for(User::class) ->allowedSearch(['name', 'email']) ->allowedFilters(['status', 'role']) ->allowedSorts(['name', 'created_at']) ->defaultSort('-created_at') ->paginate(); ``` Documentation ------------- [](#documentation) For detailed documentation, see the [docs](docs/) folder: - [Overview](docs/overview.md) - Getting started and basic concepts - [Search](docs/search.md) - Global search across columns - [Filters](docs/filters.md) - Filter types and custom filters - [Sorting](docs/sorting.md) - Sortable columns and custom sorts - [Pagination](docs/pagination.md) - Pagination options and configuration Usage Examples -------------- [](#usage-examples) ### Search [](#search) Enable global search across columns: ``` $users = QueryBuilder::for(User::class) ->allowedSearch(['name', 'email', 'bio']) ->get(); // Request: ?search=john ``` ### Filters [](#filters) Apply various filter types: ``` use Accelade\QueryBuilder\Filters\Filter; $users = QueryBuilder::for(User::class) ->allowedFilters([ Filter::exact('status'), Filter::partial('name'), Filter::scope('active'), ]) ->get(); // Request: ?filter[status]=active&filter[name]=john ``` ### Sorting [](#sorting) Enable column sorting: ``` $users = QueryBuilder::for(User::class) ->allowedSorts(['name', 'email', 'created_at']) ->defaultSort('-created_at') ->get(); // Request: ?sort=name or ?sort=-created_at (descending) ``` ### Pagination [](#pagination) ``` // Standard pagination $users = QueryBuilder::for(User::class) ->allowedPerPage([10, 25, 50, 100]) ->defaultPerPage(25) ->paginate(); // Simple pagination (better performance) $users = QueryBuilder::for(User::class)->simplePaginate(15); // Cursor pagination (infinite scroll) $users = QueryBuilder::for(User::class)->cursorPaginate(15); ``` ### Combining Features [](#combining-features) ``` $users = QueryBuilder::for(User::class) ->allowedSearch(['name', 'email']) ->allowedFilters(['status', 'role']) ->allowedSorts(['name', 'created_at']) ->defaultSort('-created_at') ->defaultPerPage(25) ->paginate(); // Request: ?search=john&filter[status]=active&sort=-created_at&per_page=50 ``` Using the Facade ---------------- [](#using-the-facade) ``` use Accelade\QueryBuilder\Facades\QueryBuilder; $users = QueryBuilder::for(User::class) ->allowedSearch(['name', 'email']) ->paginate(); ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review our [security policy](.github/SECURITY.md) on how to report security vulnerabilities. Credits ------- [](#credits) - [Fady Mondy](https://github.com/fadymondy) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE) for more information. ### Health Score 43 — FairBetter than 91% of packages Maintenance85 Actively maintained with recent releases Popularity16 Limited adoption so far Community13 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 75% 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 Unknown Total 1 Last Release 110d 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 (6 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)") --- Tags laravelpaginationeloquentbladefiltersortquery builderaccelade ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/accelade-query-builder/health.svg) ``` [![Health](https://phpackages.com/badges/accelade-query-builder/health.svg)](https://phpackages.com/packages/accelade-query-builder) ``` ### Alternatives [tucker-eric/eloquentfilter An Eloquent way to filter Eloquent Models 1.8k4.8M26](/packages/tucker-eric-eloquentfilter)[mehdi-fathi/eloquent-filter Eloquent Filter adds custom filters automatically to your Eloquent Models in Laravel.It's easy to use and fully dynamic, just with sending the Query Strings to it. 450191.6k1](/packages/mehdi-fathi-eloquent-filter)[reedware/laravel-relation-joins Adds the ability to join on a relationship by name. 2121.2M13](/packages/reedware-laravel-relation-joins)[jedrzej/pimpable Laravel 4/5/6 package that allows to dynamically filter, sort and eager load relations for your models using request parameters 105179.0k1](/packages/jedrzej-pimpable)[indexzer0/eloquent-filtering Powerful eloquent filtering 22425.9k3](/packages/indexzer0-eloquent-filtering)[czim/laravel-filter Filter for Laravel Eloquent queries, with support for modular filter building 8973.0k3](/packages/czim-laravel-filter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)