README

A type-safe, fluent PHP implementation of JSON Schema Draft 2020-12.

Installation

composer require specdocular/php-json-schema

Usage

Build JSON Schema definitions using a fluent, type-safe API:

use Specdocular\JsonSchema\Draft202012\StrictFluentDescriptor;
use Specdocular\JsonSchema\Draft202012\Keywords\Properties\Property;

$schema = StrictFluentDescriptor::object()
    ->properties(
        Property::create('name', StrictFluentDescriptor::string()->minLength(1)),
        Property::create('email', StrictFluentDescriptor::string()->format('email')),
        Property::create('age', StrictFluentDescriptor::integer()->minimum(0)),
    )
    ->required('name', 'email');

// Compile to array
$compiled = $schema->compile();

// Or encode directly to JSON
$json = json_encode($schema, JSON_PRETTY_PRINT);

Strict vs Loose Descriptors

• StrictFluentDescriptor (recommended) — provides type-specific method autocomplete. Methods like minLength() are only available on string schemas, minimum() only on numeric schemas, etc.
• LooseFluentDescriptor — exposes all keywords on every schema. Useful when building schemas with multiple types.

Features

• Full JSON Schema Draft 2020-12 support (all 50 keywords, 7 vocabularies)
• Type-safe fluent API with IDE autocomplete
• Extensible keyword and vocabulary system
• Built-in schema validation (VocabularyValidator, MetaSchemaValidator)
• Framework-agnostic — no dependencies on Laravel or any framework

Note: This library builds JSON Schema definitions. It does not validate data against schemas — use a validation library like justinrainbow/json-schema for that.

Related Packages

License

MIT. See LICENSE for details.