PHPackages                             basilisk/modelfilter - 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. basilisk/modelfilter

ActiveLibrary[Database & ORM](/categories/database)

basilisk/modelfilter
====================

ModelFilter provides an easy way to filter Eloquent Models

00PHP

Since Aug 16Pushed 4y ago1 watchersCompare

[ Source](https://github.com/sahand-kh/modelfilter)[ Packagist](https://packagist.org/packages/basilisk/modelfilter)[ RSS](/packages/basilisk-modelfilter/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel Eloquent Model Filter
=============================

[](#laravel-eloquent-model-filter)

Introduction
------------

[](#introduction)

ModelFilter is a Laravel package for filtering Eloquent models. it is very easy to use and can be configured to match your needs. Lets say you want to enable api to filter results by multiple parameters, ModelFilter can dynamically filter results and return a collection or maybe you want to also do some process or add other conditions after filter is implemented, no problem, ModelFilter can return the model instead of the collection

Requirements
------------

[](#requirements)

- PHP 8.0
- Laravel 6.x, 7.x, 8.x

Installation
------------

[](#installation)

#### Install with Composer

[](#install-with-composer)

```
composer require basilisk/modelfilter

```

Supported Matching Strategies
-----------------------------

[](#supported-matching-strategies)

- **exact:** search for fields that are equal to the search param. Numerical fields should always use exact matching strategy
- **partial:** search for fields that contain the search param.
- **start:** search for fields that start with the search param.
- **end:** search for fields that end with the search param.
- **exist:** in this case the search key is the relation name and search value is a boolean value specifying if we interested in relation existence or absence.

Configuration
-------------

[](#configuration)

You need to specify filter rules in your model. To do this you have to add a public property called ***$filtersConfigs*** to your models. ***filtersConfigs*** accepts an associative array where keys are specifying fields and relations and values are the search rules. for example imagine we add following ***filtersConfigs*** to the User model:

```
public $filtersConfigs = [
'id' => 'exact',
'first_name' =>'partial',
'roles:id' => 'exact',
'roles' => 'exist'
];

```

As can be seen, you can filter based on properties of the related models, for instance ***'roles:id'*** helps you to filter users based on their role's id. You can chain as many relation as you want. For example imagine User has a relation called books and in turn Book model has a relation called category and each category has a property called name. For filtering users based the category name of the books in which user is associated with, you can define following filter rule:

```
public $filtersConfigs = [
'books:category:name' => 'exact'
];

```

Usage
-----

[](#usage)

To implement filters, all you need to do is to call Filter Facade and pass two arguments, first is the Model class which you define ***filtersConfigs*** and the second is an associative array of search keys and values. Although there is no rule for the source of this associative array however in real world scenarios you usually get these key-value pairs from query string:

```
ModelFilterFacade::filter(User::class, $request->query())

```

An example for setting query strings to filter the results could be as follow:

```
Base_url/users?books:category:name=fantasy&roles=true

```

You can define several values for a single key in your query string, for instance in following example every User which their name partially match 'sahand' or 'salar' would be selected

```
Base_url/users?first_name[]:sahand&first_name[]:salar

```

Specifying Return Type
----------------------

[](#specifying-return-type)

By default **ModelFilter** return a collection of the results. However you may want to do some extra checks on the model before returning the results (for instance you may want to paginate the results). In these cases you can ask ModelFilter to return the model instead of the collection. To do this all you need to do is specify third argument as false when calling the filter method:

```
$user = ModelFilterFacade::filter(User::class, $request->query(), false);
$user->paginate();

```

Set More than One Rule For A Key
--------------------------------

[](#set-more-than-one-rule-for-a-key)

You may want to define more than one rule for a search key. For instance you may want to define a rule to select user if value provided for first\_name exactly matches and another for partially match. To make this happened you need to define rules as you always did but append filter strategy to the search key.

```
 public $filtersConfigs = [
'first_name:exact' =>'exact',
'first_name:partial' =>'partial',
];

```

Now you can specify which filter should be used dynamically and in runtime, for example to filter users based on their first name on exact match you can set query strings as follow:

```
Base_url/users?first_name:exact=sahand

```

and to filter users on partial match you can do as follow:

```
Base_url/users?first_name:partial=sah

```

###  Health Score

14

—

LowBetter than 2% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/75389ddc7a32c316fcbda9adb7989555bdb5c86f689c68c3c4ecfd9a8798d10b?d=identicon)[sahand.khodaparast@gmail.com](/maintainers/sahand.khodaparast@gmail.com)

---

Top Contributors

[![sahand-kh](https://avatars.githubusercontent.com/u/29306449?v=4)](https://github.com/sahand-kh "sahand-kh (6 commits)")

### Embed Badge

![Health badge](/badges/basilisk-modelfilter/health.svg)

```
[![Health](https://phpackages.com/badges/basilisk-modelfilter/health.svg)](https://phpackages.com/packages/basilisk-modelfilter)
```

###  Alternatives

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.3k](/packages/illuminate-database)[mongodb/mongodb

MongoDB driver library

1.6k64.0M543](/packages/mongodb-mongodb)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90340.3M209](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)