https://github.com/atk4/validate

Integration of atk4/data with Valitron for rule-based data validation.
https://github.com/atk4/validate

agile atk4 php validate

Last synced: 10 days ago
JSON representation

Integration of atk4/data with Valitron for rule-based data validation.

• Host: GitHub
• URL: https://github.com/atk4/validate
• Owner: atk4
• License: mit
• Created: 2018-12-13T21:11:29.000Z (over 6 years ago)
• Default Branch: develop
• Last Pushed: 2025-01-21T15:20:08.000Z (3 months ago)
• Last Synced: 2025-04-13T12:08:09.676Z (10 days ago)
• Topics: agile, atk4, php, validate
• Language: PHP
• Homepage: https://agiletoolkit.org/
• Size: 71.3 KB
• Stars: 4
• Watchers: 9
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Validator for Agile Data

This is validator add-on for Agile Data (https://github.com/atk4/data).

It uses https://github.com/vlucas/valitron under the hood.

[![Code Climate](https://codeclimate.com/github/atk4/validate/badges/gpa.svg)](https://codeclimate.com/github/atk4/validate)

[![StyleCI](https://styleci.io/repos/161695320/shield)](https://styleci.io/repos/161695320)

[![CodeCov](https://codecov.io/gh/atk4/validate/branch/develop/graph/badge.svg)](https://codecov.io/gh/atk4/validate)

[![Test Coverage](https://codeclimate.com/github/atk4/validate/badges/coverage.svg)](https://codeclimate.com/github/atk4/validate/coverage)

[![Issue Count](https://codeclimate.com/github/atk4/validate/badges/issue_count.svg)](https://codeclimate.com/github/atk4/validate)

[![License](https://poser.pugx.org/atk4/validate/license)](https://packagist.org/packages/atk4/validate)

[![GitHub release](https://img.shields.io/github/release/atk4/validate.svg?maxAge=2592000)](CHANGELOG.md)

# Usage

``` php

// add model fields

$model->addField('name');

$model->addField('age', ['type' => 'number']);

$model->addField('type', ['required' => true, 'enum' => ['dog', 'ball']]);

$model->addField('tail_length', ['type' => 'number']);

// add validator to your model

// also will register itself as $model->validator property

$v = new \Atk4\Validate\Validator($model);

// set simple validation rule for one field

// ->rule($field, $rules)

$v->rule('name', [ 'required', ['lengthMin', 3] ]);

// set multiple validation rules in one shot

// ->rules($array_of_rules) // [field=>rules]

$v->rules([

    'name' => ['required', ['lengthMin',3]],

    'age' => ['integer', ['min',0], ['max',99]],

    'tail_length' => ['integer', ['min',0]],

]);

// set validation rules based on value of another field

// if type=dog, then sets fields age and tail_length as required

// ->if($condition, $then_array_of_rules, $else_array_of_rules)

$v->if(['type'=>'dog'], [

    'age' => ['required'],

    'tail_length' => ['required'],

], [

    'tail_length' => [ ['equals',''] ], // balls don't have tail

]);

// you can also pass multiple conditions which will be treated as AND conditions

$v->if(['type'=>'dog', 'age'=>50], $rules_if_true, $rules_if_false);

// you can also set custom error message like this:

$v->rule('age', [ ['min', 3, 'message'=>'Common! {field} to small'] ]);

// and you will get this "Common! Age to small"

```

You can also pass callback instead of array of rules.

Callback receives these parameters $field, $value, $args, $data and should return true/false.

See `/tests` folder for more examples.