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.

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.