project validator {🖫 507, ⚐ 26, ★ 0}

chmielewskitomasz/validator

Simple validation tool, allows you to validate both simple and nested structures, introduces conditional fields. All you need is here. Perfect for REST endpoint validation. No dependencies required.

Tuesday, July 17, 2018
by chmielewskitomasz
Repository
1 Watchers
0 Stars
507 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
26 Versions
61 % Grown

The README.md

Simple, lightweight input validation lib for PHP

, _(*1)

, _(*2)

How to install it?

composer require chmielewskitomasz/validator

How to use it?

require_once __FILE__ . '/vendor/autoload.php';

use Hop\Strategy\Strategy;
use Hop\Strategy\Field;
use Hop\StdValidator;

// first, create your input validation strategy
class AlbumInputValidator implements Strategy
{
    /**
     * @inheritdoc
     */
    public function getFields(): array
    {
        $nameField = new Field(
            'name',
            true,
            null
        );

        $phoneField = new Field(
            'phone'
            false,
            null
        );

        $phoneField->registerValidator('Digits');
        $phoneField->registerValidator('Length', ['min' => 9, 'max' => 9]);

        return [
            $nameField,
            $phoneField
        ];
    }
}

// second, create stdValidator
$validator = StdValidator::fromConfig(include __DIR__ . '/config/validators.php');


// three - validate your input
$myInput = [
    'name' => 'Tom',
    'phone' => '999888000'
];
$validator->isValid($myInput, new AlbumInputValidator());  // true
$validator->getMessages($myInput, new AlbumInputValidator());  // null


$myWrongInput = [
    'name' => 'Tom',
    'phone' => 'thisShouldBeA9DigitsNumber'
];
$validator->isValid($myWrongInput, new AlbumInputValidator()) // false
$validator->getMessages($myWrongInput, new AlbumInputValidato()) 
//  ['phone' => Message()]

Ok, I want my field to be optional, but if it is passed I want to validate it

//    In strategy: 
//    ...
    public function getFields(): array
    {
        $field = new Field(
            'phone',
            false, // set second parameter 'required' as false,
            null
        );

        $field->registerValidator('Digits', null);

        return [$field];
    }
//    ...


// and then
$validator->isValid([], new AlbumInputValidator()); // true
$validator->isValid(['phone' => 'abcdefg'], new AlbumInputValidator()); // false

I want a single field to be conditional. I mean, if eg street name is not passed, I don't want house number to be required.

Have a look:, _(*3)

//    In strategy: 
//    ...
    public function getFields(): array
    {
        $streetField = new Field(
            'street',
            false,
            null
        );

        $houseNumberField = new Field(
            'houseNumber',
            true,
            function (array $inputData) {
                return !isset($inputData['street']);
            }
        );

        return [$streetField, $houseNumberField];
    }
//    ...


// and then
$validator->isValid(['street' => 'High st.'], new AlbumInputValidator()); // false
$validator->isValid([], new AlbumInputValidator()); // true
$validator->isValid(['street' => 'High st.', 'houseNumber' => '12'], new AlbumInputValidator()); // true

How can I implement my own validators?

Easily. You can help me to contribute this project. Or if you don't want to, just create a class implementing Hop\Validator\Strategy\Strategy and pass it to StdValidator::fromConfig() as array, eg, _(*4)

$myValidators = [
    'MyValidator' => 'Path\To\Validator\Class'
];

$validator = StdValidator::fromConfig(
    \array_merge(include __DIR__ . '/config/validators.php', $myValidators)
);

The Versions

17/07 2018

dev-master

9999999-dev

Simple validation tool, allows you to validate both simple and nested structures, introduces conditional fields. All you need is here. Perfect for REST endpoint validation. No dependencies required.

project validator

Simple validation tool, allows you to validate both simple and nested structures, introduces conditional fields. All you need is here. Perfect for REST endpoint validation. No dependencies required.

chmielewskitomasz/validator

The README.md

Simple, lightweight input validation lib for PHP

How to install it?

How to use it?

Ok, I want my field to be optional, but if it is passed I want to validate it

I want a single field to be conditional. I mean, if eg street name is not passed, I don't want house number to be required.

How can I implement my own validators?

The Versions

dev-master

The Requires

The Development Requires

1.2.7

The Requires

The Development Requires

1.2.6

The Requires

The Development Requires

1.2.5

The Requires

The Development Requires

1.2.4

The Requires

The Development Requires

1.2.3

The Requires

The Development Requires

1.2.2

The Requires

The Development Requires

1.2.1

The Requires

The Development Requires

dev-feature/nested-validators

The Requires

The Development Requires

1.2.0

The Requires

The Development Requires

1.1.6

The Requires

The Development Requires

1.1.5

The Requires

The Development Requires

1.1.4

The Requires

The Development Requires

1.1.3

The Requires

The Development Requires

1.1.2

The Requires

The Development Requires

1.1.1

The Requires

The Development Requires

1.1.0

The Requires

The Development Requires

1.0.8

The Requires

The Development Requires

1.0.7

The Requires

The Development Requires

1.0.6

The Requires

The Development Requires

1.0.5

The Requires

The Development Requires

1.0.4

The Requires

The Development Requires

1.0.3

The Requires

The Development Requires