getdkan/rooted-json-data

Access and modify JSON-based data objects while enforcing JSON Schema

0.2.3 2025-03-13 19:25 UTC

Requires

• ext-json: *
• galbar/jsonpath: ^3.0
• opis/json-schema: ^1.2.0

Requires (Dev)

• phpunit/phpunit: ^9.6.20
• rector/rector: ^2.0.0
• squizlabs/php_codesniffer: ^3.7
• symfony/phpunit-bridge: ^7.2

GPL-3.0-or-later

• fmizzell
• Dan Feder

README

Access and modify JSON-based data objects while enforcing JSON Schema.

This library primarily wires together JsonPath-PHP and Opis JSON Schema, providing a JSON Object class that functions like a small internal service. Data can be added, retrieved and modified through a simple API, and any changes will immediately provoke a re-validation. Validation errors through exceptions with actionable messages.

Example:

$json = '{"number":3}';
$schema = '{"type": "object","properties": {"number":{ "type": "number" }}}';
$data = new RootedJsonData($json, $schema);
echo $data->{"$.number"}; // 3
echo $data->{"$[number]"}; // 3
echo "{$data}"; // {"number":3}
$data->{"$.number"} = "three"; // EXCEPTION