simonisme/validator

2.5.1 2017-09-17 13:36 UTC

Requires

• php: >=7.0.0

Requires (Dev)

• phpunit/phpunit: 6.2

MIT

README

How to use one validator?

$validator = new IsEmailValidator();
$result = $validator->valid('[e-mail]');

//  $result contains 0 when evrything is ok
//  or value > 1 otherwise

How to check value with many validators?

validThroughAllValidators() method checks given value in ALL validators.

$collection = new ValidatorsCollection(
    [
        new IsNotNullValidator(),
        new IsEmailValidator(),
    ]
);

$result = $collection->validThroughAllValidators('[e-mail]');

$result->isValid();     // returns true if value is passed thought all validators
$result->errors();      // returns array of error numbers for each of not-passed validators

validToFirstError() method checks given value in all validators TO FIRST FAIL.

$collection = new ValidatorsCollection(
    [
        new IsNotNullValidator(),
        new IsEmailValidator(),
    ]
);

$result = $collection->validToFirstError('[e-mail]');

$result->isValid();     // returns true if value is passed thought all validators
$result->errors();      // returns array of error numbers (in this case there will be only single element in array) for each of not-passed validators

How to check array of values?

You can create array full of validators. This array can contain nested validators arrays:

$validators = [
    "email" => new IsEmailValidator(),
    "age" => new IsNumberValidator()
];

This $validators array can be used to validate $data array:

$data = [
    "email" => "incorrect email address",
    "age" => 35
];

$arrayValidator = mew ArrayValidator(); 
$result = $arrayValidator->validateArray($validators, $data);

$result variable contains ValidationResult objects. ValidationResult::errors() returns nested array with error codes.

For more example look into ./tests/unit/ArrayValidatorTest.php

LIST OF VALIDATORS

• IsBoolValidator
• IsDateTimeValidator
• IsDateValidator
• IsEmailValidator
• IsIntegerValidatorTest
• IsNotNullValidator
• IsNullValidator
• IsNumberEqualValidator
• IsNumberGreaterOrEqualValidator
• IsNumberGreaterThanValidator
• IsNumberInExclusiveRangeValidator
• IsNumberInInclusiveRangeValidator
• IsNumberLessOrEqualValidator
• IsNumberLessThanValidator
• IsNumberValidator
• IsSetValidator
• IsStringValidator
• IsTimeValidator
• IsUrlValidator
• IsValueFromSetValidatorTest
• StringLengthValidator
• SetValidator

License

MIT (https://en.wikipedia.org/wiki/MIT_License)