kris-kuiper/validator

Modern PHP validator on steroids for validating forms and/or array's.

v1.5.7 2023-05-11 22:26 UTC

Requires

• php: >=8.0
• ext-mbstring: *

Requires (Dev)

• brianium/paratest: ^6.4
• phpro/grumphp: ^1.12
• phpstan/phpstan: ^1.7
• phpunit/phpunit: ^9
• slevomat/coding-standard: ^7.2
• vimeo/psalm: ^4.27

MIT

• Kris Kuiper

• php
• form
• validator
• validation
• array
• validate
• modern

README

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 or create your own 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 after validation;
• Combine multiple fields as one for single validation (i.e. day, month, year inputs as a single date field for validation);
• Use validation blueprints to extend other validators for DRY method;
• Define you own validation rules and custom error messages.

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

Modern PHP Validator is available on Packagist (using semantic versioning). Installation via Composer 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

All documentation can be found in the docs folder.

Index:

• Intro
  • Introduction
  • Head first example
• Installation
  • Installation
• Execute validation
  • Adding fields for validation
  • Execute validation
• Validation rules
  • Special required rules
  • Rules
  • Stopping on first validation rule failure
• Custom validation rules
  • Using rule class objects
  • Using closures
• Conditional rules
  • Conditionally adding rules
• Validation filtering
  • Filtering values based on validation rules
• Combining
  • Combining fields for single validation
• Errors messages
  • Working with error messages
  • Retrieving error messages
  • Working with error objects
  • Custom error messages
• Retrieving validated data
  • Returning only validated data
  • Filtering validated data
  • Filter empty values
  • Convert empty values
  • Using Templates
• Aliases
  • Field name aliases
• Blueprints
  • Validation blueprints
• Middleware
  • Using middleware
  • Predefined middleware
  • Custom middleware
• Default values
  • Default values
• Events
  • Before event
  • After event
• Storage
  • Storage
• Examples
  • Validating registration form
  • Password validation
  • Combining multiple date fields for single validation
  • Using blueprints
• License
  • License

Validation rules

Below is a list with all predefined validation rules.

Accepted	Date	Is empty	Prohibits
Accepted if	DateBetween	Is false	Regex
Accepted not empty	Declined	Is int	Required
Active URL	Declined if	Is not null	Required array keys (array)
After (date)	Declined not empty	Is null	Required with
After or equal (date)	Different	Is string	Required with all
Alpha	Different with all	Is true	Required without
Alpha dash	Digits	Json	Required without all
Alpha numeric	Digits between	Length	Same
Alpha space	Digits max	Length between	Same not
Before (date)	Digits min	Length max	Scalar
Before or equal (date)	Distinct	Length min	Starts not with
Between	Divisible by	Lowercase	Starts with
CSS Color	Email	MAC address	Time zone
Confirmed	Ends not with	Max	Uppercase
Contains	Ends with	Min	URL
Contains letter	Equals	Negative	UUID
Contains mixed case	Hexadecimal	Negative or zero	UUID v1
Contains not	In	Not in	UUID v3
Contains number	IP	Nullable	UUID v4
Contains symbol	IP private	Number	UUID v5
Count (array)	IP public	Positive	Words
Countable (array)	IP v4	Positive or zero	Words max
Count between (array)	IP v6	Present	Words min
Count max (array)	Is array	Prohibited
Count min (array)	Is bool	Prohibited if

Head first example:

use KrisKuiper\Validator\Validator;

$data = [
    'department' => 'office',
    'color' => 'black',
    'programmer' => [
        'name' => 'Morris',
        'email' => '[e-mail]'
    ],
];

$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 for lots of more validation goodies.

License

Modern PHP Validator is open-sourced software licensed under the MIT license.