windwalker/validator

Windwalker Validator package

Windwalker Validator

Windwalker Validator is a simple interface to help up validate strings., _(*1)

Installation via Composer

Add this to the require block in your composer.json., _(*2)

``` json { "require": { "windwalker/validator": "~3.0" } }, <sub>(*3)</sub>

## Simple Validate Process

``` php
use Windwalker\Validator\Rule\EmailValidator;

$validator = new EmailValidator;

$validator->validate('sakura@flower.com'); // bool(true)

$validator->validate('sakura'); // bool(false)

Available Validator Rules

• AlnumValidator
• BooleanValidator
• ColorValidator
• CreditcardValidator
• EmailValidator
• EqualsValidator
• IpValidator
• NoneValidator
• PhoneValidator
• RegexValidator
• UrlValidator
• CallbackValidator
• CompareValidator
• PhpTypeValidator

Regex Validator

``` php use Windwalker\Validator\Rule\RegexValidator;, <sub>(*4)</sub>

$validator = new RegexValidator('^[a-zA-Z0-9]*$', 'i');, <sub>(*5)</sub>

$validator->validate('abc_123:978'); // bool(false), <sub>(*6)</sub>

## Equals Validator

``` php
use Windwalker\Validator\Rule\EqualsValidator;

$validator = new EqualsValidator('ABC');

$validator->validate('ABC'); // bool(true)

Strict Mode:, <sub>(*7)</sub>

``` php $validator = new EqualsValidator(123, true);, <sub>(*8)</sub>

$validator->validate('123'); // bool(false), <sub>(*9)</sub>

## Error Message

``` php
$validator->setMessage('This string is not valid');

if (!$validator->validate('sakura'))
{
    throw new \Exception($validator->getError());
}

Create Your Own Validator

``` php use Windwalker\Validator\AbstractValidator;, <sub>(*10)</sub>

class MyValidator extends AbstractValidator { public function test($string) { return (bool) strlen($string); } }, <sub>(*11)</sub>

$validator = new MyValidator;, <sub>(*12)</sub>

$validator->validate('foo');, <sub>(*13)</sub>

## Extends Regex Validator

``` php
use Windwalker\Validator\Rule\RegexValidator;

class MyRegexValidator extends RegexValidator
{
    protected $modified = 'i';
    protected $regex = '[a-zA-Z]';
}

Composite

Match all., <sub>(*14)</sub>

use Windwalker\Validator\ValidatorComposite;

$validator = new ValidatorComposite([
    AlnumValidator::class,
    new PhoneValidator
]);

$validator->validate('1a2b'); // false
$validator->getResults(); // [true, false]

Match one., <sub>(*15)</sub>

use Windwalker\Validator\ValidatorComposite;

$validator = new ValidatorComposite([
    AlnumValidator::class,
    new PhoneValidator
])->setMode(ValidatorComposite::MODE_MATCH_ONE);

$validator->validate('1a2b'); // true
$validator->getResults(); // [true, false]

Use methods:, <sub>(*16)</sub>

$validator->validateOne($value);
$validator->validateAll($value);