Skip to content

hunomina/data-validator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Json Data Validator

Build Status codecov

Description : Library for data validation based on data schemas

This project is licensed under the terms of the MIT license.

Interfaces and classes

Allows to encapsulate the data into an object and format it in order to be validated using a DataSchema.

JsonData implements DataType.

JsonData::format() uses json_decode() to format json string into php array.


Allows to validate DataType based on rule specifications (is the data optional ?, is the data allowed to be...).

JsonRule implement DataRule.

JsonRule can validate :

Type/Check Null Length Pattern Min/Max Enum Date format Empty
String
Character
Number
Integer
Float
Boolean
Typed List

DataSchema is the library main class. It allows to validate DataType based on sub-schemas and DataRule.

DataSchema::validate() method allows this validation. If DataSchema::validate() does not validate the DataType it throws an InvalidDataException.

JsonSchema implements DataSchema and validates JsonData using JsonRule.

How it works

See tests for examples

A JsonSchema has a type : object or list.

Objects are composed of rules and "child" schemas if needed.

This is a schema definition :

use hunomina\Validator\Json\Schema\Json\JsonSchema;

$schema = new JsonSchema([
    'success' => ['type' => 'bool'],
    'error' => ['type' => 'string', 'null' => true],
    'user' => ['type' => 'object', 'null' => true, 'optional' => true, 'schema' => [
        'name' => ['type' => 'string'],
        'age' => ['type' => 'int']
    ]]
]);

Schemas are just php arrays passe to JsonSchema::setSchema() method.

This schema is composed of 3 elements :

  • a rule success which :

    • is a boolean
    • can not be null
    • is not optional
  • a rule error which :

    • is a string
    • can be null
    • is not optional
  • a "child" schema user which :

    • is an object and therefor is represented by a schema which contains 2 elements : a name (string) and an age (integer)
    • can be null
    • is optional

When a data unit is being validated using this schema by calling the JsonSchema::validate() method, the schema will check recursively if the data respects the rules and the "child" schemas.

If the data has :

  • a boolean element success
  • a null or string element error
  • an optionally, null or object element user which must have :
    • a string element name
    • an integer element age

This data is valid :

use hunomina\Validator\Json\Data\Json\JsonData;

$data = new JsonData([
    'success' => true,
    'error' => null,
    'user' => [
        'name' => 'test',
        'age' => 10
    ]
]);

This one is not :

use hunomina\Validator\Json\Data\Json\JsonData;

$data = new JsonData([
    'success' => true,
    'error' => null,
    'user' => 'test'
]);

As said earlier, rules can be used to validate length or data pattern.

This schema uses the pattern validation on the name element and the length validation on the geolocation element :

use hunomina\Validator\Json\Schema\Json\JsonSchema;

$schema = new JsonSchema([
    'name' => ['type' => 'string', 'pattern' => '/^[a-z]+$/'],
    'geolocation' => ['type' => 'integer-list', 'length' => 2]
]);

When calling the JsonSchema::validate() method, the schema will recursively check all the rule set and "child" schemas. If one rule or one "child" schema is invalid, JsonSchema::validate() returns false.

The "first level" schema is an object typed schema. It could be changed but is not meant to.

Finally, if a "child" schema is typed as an object, the schema will validate it as described above. If it's typed as a list, the schema will simply check each element of the data as an object type using the given "child" schema.