PHPackages kris-kuiper/validator - 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. [Utility & Helpers](/categories/utility) 4. / 5. kris-kuiper/validator ActiveLibrary[Utility & Helpers](/categories/utility) kris-kuiper/validator ===================== Modern PHP validator on steroids for validating forms and/or array's. v1.5.7(2y ago)91522MITPHPPHP >=8.0 Since Aug 29Pushed 2y ago1 watchersCompare [ Source](https://github.com/kris-kuiper/Validator)[ Packagist](https://packagist.org/packages/kris-kuiper/validator)[ RSS](/packages/kris-kuiper-validator/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (6)Versions (74)Used By (0) Modern PHP Validator - Standalone Validation on Steroids ======================================================== [](#modern-php-validator---standalone-validation-on-steroids) [![Modern PHP Validator](logo.png)](logo.png) [![Latest Stable Version](https://camo.githubusercontent.com/2cba89bd042afc956f576321c7d50965027e619873e6018bbeda74489345bdd6/687474703a2f2f706f7365722e707567782e6f72672f6b7269732d6b75697065722f76616c696461746f722f76)](https://packagist.org/packages/kris-kuiper/validator)[![License](https://camo.githubusercontent.com/7ae685e63e3c2fab4e3dde162f138ecf4c270ef74bc0e57360ce83462ed0b44e/687474703a2f2f706f7365722e707567782e6f72672f6b7269732d6b75697065722f76616c696461746f722f6c6963656e7365)](https://packagist.org/packages/kris-kuiper/validator)[![PHP Version Require](https://camo.githubusercontent.com/eca74cbb6b2eaf2a4fe7fea87eede010b996f0702cea7728dea316cb5ed3a45b/687474703a2f2f706f7365722e707567782e6f72672f6b7269732d6b75697065722f76616c696461746f722f726571756972652f706870)](https://packagist.org/packages/kris-kuiper/validator)[![codecov](https://camo.githubusercontent.com/f9092e131735aa8b6f29c845990465554fe17ab01ac156a3d7c1d4959b1b4b62/68747470733a2f2f636f6465636f762e696f2f67682f6b7269732d6b75697065722f76616c696461746f722f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/kris-kuiper/validator) Introduction ------------ [](#introduction) Validating incoming data or array's (i.e. POST data) should not be hard. Meet Modern PHP Validator which does the trick nice, clean and easy. Here are a couple of the many perks: - 100+ predefined validation rules; - 15+ predefined [middleware](/docs/13%20-%20Middleware/13.2%20-%20Predefined%20middleware.md) or [create your own](/docs/13%20-%20Middleware/13.3%20-%20Custom%20middleware.md) custom middleware; - No new syntax you need to learn as in the case with i.e. Laravel Validator. Your editor/IDE can complete every validation rule, custom message, middleware, etc. out of the box; - Easy [retrieving the validated data](/docs/10%20-%20Retrieving%20validated%20data/10.1%20-%20Returning%20only%20validated%20data.md) after validation; - [Combine](/docs/08%20-%20Combining%20fields%20for%20single%20validation/8.1%20-%20Combining%20fields.md) multiple fields as one for single validation (i.e. day, month, year inputs as a single date field for validation); - Use validation [blueprints](/docs/12%20-%20Validation%20blueprints/12.1%20-%20Using%20blueprints.md) to extend other validators for [DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) method; - Define you [own validation rules](/docs/05%20-%20Custom%20validation%20rules/5.2%20-%20Using%20closures.md) and [custom error messages](/docs/09%20-%20Errors%20messages/9.4%20-%20Custom%20error%20messages.md). Modern PHP Validator provides several approaches to validate your application's (incoming) data. It makes it a breeze to validate form submit values as combining multiple input for single validation. It supports middleware and custom validation rules and error messages. It will also return the validated data to insert the data into i.e. a database. Installation ------------ [](#installation) Modern PHP Validator is available on Packagist (using semantic versioning). Installation via [Composer](https://getcomposer.org/) is the recommended way. Run: ``` composer require kris-kuiper/validator ``` Or add this line to your composer.json file: ``` "kris-kuiper/validator": "^1.5" ``` Documentation ------------- [](#documentation) All documentation can be found in the [docs](/docs) folder. ### Index: [](#index) - Intro - [Introduction](/docs/01%20-%20Intro/1.1%20-%20Introduction.md) - [Head first example](/docs/01%20-%20Intro/1.2%20-%20Head%20first%20example.md) - Installation - [Installation](/docs/02%20-%20Installation/2.1%20-%20Installation.md) - Execute validation - [Adding fields for validation](/docs/03%20-%20Execute%20validation/3.1%20-%20Adding%20fields%20for%20validation.md) - [Execute validation](/docs/03%20-%20Execute%20validation/3.2%20-%20Execute%20validation.md) - Validation rules - [Special required rules](/docs/04%20-%20Validation%20rules/4.1%20-%20Special%20required%20rules.md) - [Rules](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md) - [Stopping on first validation rule failure](/docs/04%20-%20Validation%20rules/4.3%20-%20Stopping%20on%20first%20validation%20rule%20failure.md) - Custom validation rules - [Using rule class objects](/docs/05%20-%20Custom%20validation%20rules/5.1%20-%20Using%20rule%20class%20objects.md) - [Using closures](/docs/05%20-%20Custom%20validation%20rules/5.2%20-%20Using%20closures.md) - Conditional rules - [Conditionally adding rules](/docs/06%20-%20Conditional%20validation/6.1%20-%20Conditionally%20adding%20rules.md) - Validation filtering - [Filtering values based on validation rules](/docs/07%20-%20Filtering%20values%20based%20on%20rules/7.1%20-%20Filtering%20values%20based%20on%20validation%20rules.md) - Combining - [Combining fields for single validation](/docs/08%20-%20Combining%20fields%20for%20single%20validation/8.1%20-%20Combining%20fields.md) - Errors messages - [Working with error messages](/docs/09%20-%20Errors%20messages/9.1%20-%20Working%20with%20error%20messages.md) - [Retrieving error messages](/docs/09%20-%20Errors%20messages/9.2%20-%20Retrieving%20error%20messages.md) - [Working with error objects](/docs/09%20-%20Errors%20messages/9.3%20-%20Working%20with%20error%20objects.md) - [Custom error messages](/docs/09%20-%20Errors%20messages/9.4%20-%20Custom%20error%20messages.md) - Retrieving validated data - [Returning only validated data](/docs/10%20-%20Retrieving%20validated%20data/10.1%20-%20Returning%20only%20validated%20data.md) - [Filtering validated data](/docs/10%20-%20Retrieving%20validated%20data/10.2%20-%20Filtering%20validated%20data.md) - [Filter empty values](/docs/10%20-%20Retrieving%20validated%20data/10.3%20-%20Filter%20empty%20values.md) - [Convert empty values](/docs/10%20-%20Retrieving%20validated%20data/10.4%20-%20Convert%20empty%20data.md) - [Using Templates](/docs/10%20-%20Retrieving%20validated%20data/10.5%20-%20Template.md) - Aliases - [Field name aliases](/docs/11%20-%20Field%20name%20aliases/11.1%20-%20Aliases.md) - Blueprints - [Validation blueprints](/docs/12%20-%20Validation%20blueprints/12.1%20-%20Using%20blueprints.md) - Middleware - [Using middleware](/docs/13%20-%20Middleware/13.1%20-%20Using%20middleware.md) - [Predefined middleware](/docs/13%20-%20Middleware/13.2%20-%20Predefined%20middleware.md) - [Custom middleware](/docs/13%20-%20Middleware/13.3%20-%20Custom%20middleware.md) - Default values - [Default values](/docs/14%20-%20Default%20values/14.1%20-%20Default%20values.md) - Events - [Before event](/docs/15%20-%20Events/15.1%20-%20Before%20validation%20event.md) - [After event](/docs/15%20-%20Events/15.2%20-%20After%20validation%20event.md) - Storage - [Storage](/docs/16%20-%20Storage/16.1%20-%20Validation%20storage.md) - Examples - [Validating registration form](/docs/17%20-%20Examples/17.1%20-%20Validating%20registration%20form.md) - [Password validation](/docs/17%20-%20Examples/17.2%20-%20Password%20validation.md) - [Combining multiple date fields for single validation](/docs/17%20-%20Examples/17.3%20-%20Combining%20multiple%20date%20fields%20for%20single%20validation.md) - [Using blueprints](/docs/17%20-%20Examples/17.4%20-%20Using%20blueprints.md) - License - [License](#license) Validation rules ---------------- [](#validation-rules) Below is a list with all predefined validation rules. [Accepted](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#accepted)[Date](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#date)[Is empty](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-empty)[Prohibits](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#prohibits)[Accepted if](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#accepted-if)[DateBetween](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#date-between)[Is false](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-false)[Regex](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#regex)[Accepted not empty](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#accepted-not-empty)[Declined](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#declined)[Is int](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-int)[Required](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#required)[Active URL](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#active-url)[Declined if](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#declined-if)[Is not null](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-not-null)[Required array keys (array)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#required-array-keys)[After (date)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#after)[Declined not empty](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#declined-not-empty)[Is null](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-null)[Required with](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#required-with)[After or equal (date)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#after-or-equal)[Different](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#different)[Is string](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-string)[Required with all](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#required-with-all)[Alpha](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#alpha)[Different with all](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#different-with-all)[Is true](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-true)[Required without](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#required-without)[Alpha dash](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#alpha-dash)[Digits](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#digits)[Json](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#json)[Required without all](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#required-without-all)[Alpha numeric](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#alpha-numeric)[Digits between](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#digits-between)[Length](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#length)[Same](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#same)[Alpha space](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#alpha-space)[Digits max](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#digits-max)[Length between](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#length-between)[Same not](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#same-not)[Before (date)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#before)[Digits min](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#digits-min)[Length max](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#length-max)[Scalar](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#scalar)[Before or equal (date)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#before-or-equal)[Distinct](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#distinct)[Length min](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#length-min)[Starts not with](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#starts-not-with)[Between](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#between)[Divisible by](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#divisible-by)[Lowercase](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#lowercase)[Starts with](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#starts-with)[CSS Color](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#css-color)[Email](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#email)[MAC address](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#mac-address)[Time zone](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#time-zone)[Confirmed](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#confirmed)[Ends not with](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#ends-not-with)[Max](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#max)[Uppercase](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#uppercase)[Contains](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#contains)[Ends with](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#ends-with)[Min](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#min)[URL](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#url)[Contains letter](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#contains-letter)[Equals](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#equals)[Negative](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#negative)[UUID](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#uuid)[Contains mixed case](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#contains-mixed-case)[Hexadecimal](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#hexadecimal)[Negative or zero](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#negative-or-zero)[UUID v1](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#uuid-v1)[Contains not](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#contains-not)[In](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#in)[Not in](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#not-in)[UUID v3](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#uuid-v3)[Contains number](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#contains-digit)[IP](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#ip)[Nullable](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#nullable)[UUID v4](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#uuid-v4)[Contains symbol](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#contains-symbol)[IP private](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#ip-private)[Number](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#number)[UUID v5](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#uuid-v5)[Count (array)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#count)[IP public](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#ip-public)[Positive](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#positive)[Words](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#words)[Countable (array)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#countable)[IP v4](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#ip-v4)[Positive or zero](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#positive-or-zero)[Words max](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#words-max)[Count between (array)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#count-between)[IP v6](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#ip-v6)[Present](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#present)[Words min](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#words-min)[Count max (array)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#count-max)[Is array](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-array)[Prohibited](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#prohibited)[Count min (array)](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#count-min)[Is bool](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#is-boolean)[Prohibited if](/docs/04%20-%20Validation%20rules/4.2%20-%20Rules.md#prohibited-if)Head first example: ------------------- [](#head-first-example) ``` use KrisKuiper\Validator\Validator; $data = [ 'department' => 'office', 'color' => 'black', 'programmer' => [ 'name' => 'Morris', 'email' => 'morris@domain.com' ], ]; $validator = new Validator($data); //Select department and color field and attach rules $validator->field('department', 'color')->required(false)->isString()->lengthBetween(5, 20); //Select email field within the programmer array and attach rules $validator->field('programmer.email')->required()->email()->lengthMax(50); if($validator->passes()) { //Validation passes } ``` And this is just the beginning... Check out the [docs](/docs) for lots of more validation goodies. License ------- [](#license) Modern PHP Validator is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). ### Health Score 32 — LowBetter than 72% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community12 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 81.8% 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. ### Release Activity Cadence Every ~6 days Recently: every ~52 days Total 43 Last Release 1094d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/e52754716bbc5f231e07923752407f513e003239d30820689fddb349131cc228?d=identicon)[KrisKuiper](/maintainers/KrisKuiper) --- Top Contributors [![kris-kuiper](https://avatars.githubusercontent.com/u/11424934?v=4)](https://github.com/kris-kuiper "kris-kuiper (72 commits)")[![KEKuiper](https://avatars.githubusercontent.com/u/10668781?v=4)](https://github.com/KEKuiper "KEKuiper (15 commits)")[![florisluiten](https://avatars.githubusercontent.com/u/1705145?v=4)](https://github.com/florisluiten "florisluiten (1 commits)") --- Tags phpvalidatorvalidationarrayvalidateformmodern ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/kris-kuiper-validator/health.svg) ``` [![Health](https://phpackages.com/badges/kris-kuiper-validator/health.svg)](https://phpackages.com/packages/kris-kuiper-validator) ``` ### Alternatives [lezhnev74/pasvl Array Validator (regular expressions for nested array, sort of) 5253.7k3](/packages/lezhnev74-pasvl) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)