applySchema()

Apply schema defaults and remove properties not declared in the schema.

Signature

JsonFast::applySchema(
    string $json,
    string $schemaJson,
    ?int $output = OUTPUT_ARRAY
): mixed

Parameters

Name	Type	Default	Description
$json	string	—	Document to normalize
$schemaJson	string	—	Schema as JSON string
$output	?int	OUTPUT_ARRAY	Output mode

Returns

Normalized document in the requested output form.

Typical effects:

• Fill missing fields from schema default values
• Strip properties not listed under properties (when schema defines a closed shape)

Examples

Normalize user input before save:

$clean = JsonFast::applySchema(
    $request->getContent(),
    $userSchema,
    JsonFast::OUTPUT_STRING
);

$db->save($clean);

Pipeline: validate then apply:

$check = JsonFast::validateSchema($raw, $schema);

if ($check['valid']) {
    $stored = JsonFast::applySchema($raw, $schema, JsonFast::OUTPUT_STRING);
} else {
    // handle errors from $check['errors']
}

Related

• validateSchema() — check without mutating
• getSchema() — generate schema from samples