README

Description : Library for json data validation based on data schemas

This library is mainly composed of 3 interfaces and 3 classes implementing them.

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

Interfaces and classes

DataType

Allows to encapsulate the data into an object and format it for DataSchema validation.

JsonData

JsonData implements DataType.

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

Rule

Allows to validate data unit by checking if the data is null, optional and his length, pattern and type.

JsonRule

JsonRule implements Rule.

JsonRule can validate :

Type/Check	Length	Pattern	Min/Max	Enum	Date format	Empty
String	✅	✅		✅	✅	✅
Character		✅		✅
Number			✅ (value)	*TODO*
Integer			✅ (value)	✅
Float			✅ (value)	✅
Boolean
String List	✅	✅	✅ (length)	✅	*TODO*	✅
Character List	✅	✅	✅ (length)	✅		✅
Numeric List	✅		✅ (length)	✅		✅
Integer List	✅		✅ (length)	✅		✅
Float List	✅		✅ (length)	✅		✅
Boolean List	✅		✅ (length)			✅

DataSchema

DataSchema is the library main class. It allows to validate DataType based on "child" schemas and Rule.

DataSchema::validate() method allows this validation. If the DataType does not validate the DataSchema, DataSchema::validate() will return false and DataSchema::getLastError() will return the validation error.

JsonSchema

JsonSchema implements DataSchema, validates JsonData and uses JsonRule for validation.

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\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\JsonData;

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

This one is not :

use hunomina\Validator\Json\Data\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\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.

hunomina / json-data-validator

Maintainers

Details