Authorize
Decide whether the current user may apply a filter before it touches the query.
Laravel 10 · 11 · 12 · 13 ↗
Eloquent filters,without the controller noise.
Turn request data into expressive, secure queries through four purpose-built engines—without scattering conditional logic across your application.
4 filter engines1 fluent API0 controller clutter
Live pipeline
01 Request02 Payload03 Query
✓ Validated
⚡ Invokable
Generated query8 matching posts
12msPayload-firstRelation-awareValidatedSanitizedCache-readyObservable Payload-firstRelation-awareValidatedSanitizedCache-readyObservable
One package, four approaches Choose the request contract.
Choose the request contract.
Keep the same fluent query.
Each engine solves a different API shape. Start simple, go deeply relational, or accept complex boolean trees without rewriting your application layer.
01Method-driven
Invokable
Map request keys to focused PHP methods and enrich them with attributes.
?status=published&search=laravelExplore engine →02API-friendly
Ruleset
Expose an explicit field/operator/value contract for predictable REST APIs.
?filter[views][gte]=100Explore engine →03Relation-aware
Expression
Filter direct and deeply nested Eloquent relations with clear allowlists.
?filter[author.name][like]=ahmedExplore engine →04Logic-rich
Tree
Translate nested AND/OR JSON trees into correctly grouped Eloquent queries.
{ "and": [{ "field": "status" }] }Explore engine →A predictable runtimeFrom untrusted input
From untrusted input
to a clean query.
Every condition follows one visible lifecycle, so behavior stays testable as filtering grows.
See how the runtime works →Validate
Use familiar Laravel rules to reject malformed request data with useful errors.
Transform
Trim, cast, map, sanitize, or enrich values through a consistent Payload.
Apply
Generate direct or relational Eloquent constraints and record the outcome.
PostFilter.phpPHP 8.2+
class PostFilter extends Filterable
{
protected $filters = ['status', 'search'];
#[Trim]
protected function search(Payload $payload): Builder
{
return $this->builder->where(
'title', 'like', $payload->asLike('both')
);
}
}Complex when you need itYour API shape.
Your API shape.
Your engine.
Switch approaches without losing the package features around them. All engines share the same builder integration, operator pipeline, runtime context, and observability.
- ✓ Automatic builder forwarding
- ✓ Explicit field and operator allowlists
- ✓ Direct and deeply nested relations
- ✓ Strict or permissive error handling
More than query conditions
Built for real APIs.
The surrounding tools are part of the package—not an afterthought you have to rebuild in every project.
Payload APIOne value.
One value.
Its full story.
Keep the field, resolved operator, transformed value, and raw input together across the entire lifecycle.
GuardrailsSecure by design
Authorization, validation, sanitization, and explicit allowlists work before query application.
CachingFast on repeat
Multiple strategies, scoped keys, tags, profiles, and automatic invalidation.
Events & profilerSee what happened
Inspect applied and skipped payloads, subscribe to lifecycle events, and profile execution.
Developer tooling
A CLI that shortens the loop.
Set up, generate, discover, inspect, list, and test filters without leaving the terminal.
AI-ready docs
Give your coding assistant
the right context.
Download the official package instructions so AI tools use the current APIs, choose the right engine, and avoid legacy patterns.
Ready when your API isBuild filters that stay