# Laravel Fluent Validation

> Fluent validation rule builders for Laravel with IDE autocompletion, co-located array rules, and up to 160x faster wildcard validation.

## Getting started

- [Why this package?](https://sandermuller.github.io/laravel-fluent-validation/why-this-package): DX, type safety, structure, and performance — and how it compares to Laravel's Rule class.
- [Installation](https://sandermuller.github.io/laravel-fluent-validation/installation): Require the package, add the trait, and check the PHP and Laravel versions you need.
- [Getting started](https://sandermuller.github.io/laravel-fluent-validation/getting-started): One form request, three fluent rules, and a validated payload.
- [Basic usage](https://sandermuller.github.io/laravel-fluent-validation/basic-usage): Write your first fluent rules in a form request, type rules(), and use the schema() builder.
- [Error messages](https://sandermuller.github.io/laravel-fluent-validation/error-messages): Attach labels and per-rule messages to the rule itself, with no separate arrays to keep in sync.
- [Array validation](https://sandermuller.github.io/laravel-fluent-validation/array-validation): Keep parent and child rules together with each() and children(), and nest arrays naturally.

## Digging deeper

- [Extending parent rules](https://sandermuller.github.io/laravel-fluent-validation/extending-rules): Reshape inherited rules in child form requests with modifyEach and modifyChildren.
- [Livewire](https://sandermuller.github.io/laravel-fluent-validation/livewire): Use fluent rules in Livewire components with the HasFluentValidation trait.
- [Performance](https://sandermuller.github.io/laravel-fluent-validation/performance): O(n) wildcard expansion, fast-check closures, batched database checks, and the benchmarks.
- [Benchmarks](https://sandermuller.github.io/laravel-fluent-validation/benchmarks): The measured numbers, and the six rule sets behind them.
- [RuleSet](https://sandermuller.github.io/laravel-fluent-validation/ruleset): Build, compose, inspect, and validate rule collections, plus the escape hatches.
- [Validating with a RuleSet](https://sandermuller.github.io/laravel-fluent-validation/validating): validate() and check(), unknown-field handling, and named error bags.
- [Testing](https://sandermuller.github.io/laravel-fluent-validation/testing): Assert rules, RuleSets, form requests, and Livewire components with FluentRulesTester.
- [Rule reference](https://sandermuller.github.io/laravel-fluent-validation/rule-reference): Every rule type, modifier, conditional, and macro in one place.

## Migration and tooling

- [Migrating to fluent validation](https://sandermuller.github.io/laravel-fluent-validation/migration): Migrate field by field, and let the Rector companion rewrite the bulk of it for you.
- [Static analysis with PHPStan](https://sandermuller.github.io/laravel-fluent-validation/static-analysis): Opt-in PHPStan rules that flag unbounded each() chains before they reach production.
- [Troubleshooting](https://sandermuller.github.io/laravel-fluent-validation/troubleshooting): Common issues and their solutions.