# Tucker-Eric/EloquentFilter

An Eloquent Way To Filter Laravel Models And Their Relationships

Repository: https://github.com/Tucker-Eric/EloquentFilter
Canonical: https://ross.abutalabs.com/products/eloquentfilter
Homepage: http://tucker-eric.github.io/EloquentFilter
Language: PHP
License: MIT
License Family: permissive
Topics: model-filters, eloquent-filters, dynamic-filters, relation-filter, laravel, eloquent, filter-logic, eloquent-models, filter, query, laravel-filter, eloquentfilter
Last push: 2026-03-10T02:16:29+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 71, release rhythm 62, longevity 100
- inputs: {"age_days": 3834, "days_push": 177, "days_rel": 177, "gap_med": 77.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1765, forks 125 (observed 2026-08-28T04:05:33.051328+00:00)

## What it is
A Laravel package that lets you filter Eloquent models and their relationships dynamically using request input, replacing boilerplate conditional query building with declarative filter classes. It maps query string parameters to reusable filter methods defined per model.

## Use cases
- filter laravel models by query string parameters
- build dynamic list endpoints with multiple optional filters
- filter eloquent models and their relationships
- clean up controller query building code
- apply request-based filters to eloquent queries
- filter users by name, company, and roles from url params

## When to avoid
- you don't use Laravel or Eloquent ORM
- you need full-text or vector search rather than database query filtering
- your filtering needs are simple enough for a couple of where clauses

## Facets
- artifact type: library
- maturity: stable
- function: orm, database, web-framework
- domain: web-development, backend, databases
- platform: php
- tags: laravel, eloquent, query-filtering, model-filters, dynamic-queries, web-server

## Member repositories
- Tucker-Eric/EloquentFilter (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:33.051328+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:26:36.445062+00:00, confidence not recorded.
  - readme: https://github.com/Tucker-Eric/EloquentFilter (fetched 2026-08-28T04:05:33.051328+00:00, sha 1088e9f954b9)
  - homepage: http://tucker-eric.github.io/EloquentFilter (fetched 2026-08-29T11:04:54.841592+00:00, sha 8afb4973cb07)
- Data as of 2026-08-30T08:39:29.467469+00:00.
