Fluent ValidationLaravel validation rules your IDE understands

Typed, chainable rule builders with co-located array rules, labels and messages attached to the rule itself, and wildcard validation up to 160x faster.

Get started

Why this package?

GitHub

Your IDE knows the rules

One typed builder per rule category: string, integer, date, email, file. Each exposes only the methods that apply, and autocompletion replaces the string-syntax cheat sheet.

Co-located array rules

each() and children() keep parent and child rules in one place instead of scattered across dot-notation keys. Nested arrays nest naturally.

Up to 160x faster

O(n) wildcard expansion, fast-check closures, batched database checks, and rule-parse memoization on every optimized entry point.

Labels and messages on the rule

The label and the custom error message travel with the rule definition, so there is no separate messages() or attributes() array to drift out of sync.

Automated migration

A companion Rector package rewrites existing string and Rule object validation. 448 files converted in real-world testing with zero regressions.

First-class testing

FluentRulesTester asserts rules, RuleSets, FormRequests, custom Validators, and Livewire components without standing up the HTTP kernel.

From strings to fluent

php

// Before
'name'         => 'required|string|min:2|max:255',
'email'        => ['required', 'email', Rule::unique('users')->ignore($id)],
'items'        => 'array',
'items.*.id'   => 'required|integer|exists:items,id',
'items.*.name' => 'required|string|max:255',

// After
'name'  => FluentRule::string('Full Name')->required()->min(2)->max(255),
'email' => FluentRule::email('Email')->required()->unique('users', 'email', fn ($r) => $r->ignore($id)),
'items' => FluentRule::array()->each([
    'id'   => FluentRule::integer()->required()->exists('items', 'id'),
    'name' => FluentRule::string()->required()->max(255),
]),

Install with Composer and add one trait to your form request. Existing string rules keep working while you migrate field by field.

bash

composer require sandermuller/laravel-fluent-validation

Where to next

Step 1InstallationRequire the package, add the trait, and check the PHP and Laravel versions you need.Step 2Basic usageWrite your first fluent rules in a form request, type rules(), and use the schema() builder.Step 3Array validationKeep parent and child rules together with each() and children(), and nest arrays naturally.