PHPackages                             phpnomad/json-schema - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. phpnomad/json-schema

ActiveLibrary[Validation & Sanitization](/categories/validation)

phpnomad/json-schema
====================

Platform-agnostic JSON Schema validation contract for PHPNomad. Ships interfaces only — pair with a concrete integration package (e.g. opis-json-schema-integration).

1.0.0(1mo ago)01.0k↓66.7%[1 PRs](https://github.com/phpnomad/json-schema/pulls)1MITPHPPHP >=8.2CI passing

Since Apr 19Pushed 1mo agoCompare

[ Source](https://github.com/phpnomad/json-schema)[ Packagist](https://packagist.org/packages/phpnomad/json-schema)[ Docs](https://github.com/phpnomad/json-schema)[ RSS](/packages/phpnomad-json-schema/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (1)Versions (3)Used By (1)

PHPNomad JSON Schema
====================

[](#phpnomad-json-schema)

Platform-agnostic JSON Schema validation contract for PHPNomad. Your code depends on a small interface; the concrete validator implementation is swappable without touching consumers.

This package ships **interfaces only**. Pair it with an implementation package — for example, a wrapper around [`opis/json-schema`](https://github.com/opis/json-schema), or roll your own against any library that exposes per-violation metadata.

Requirements
------------

[](#requirements)

PHP 8.2 or newer.

Installation
------------

[](#installation)

```
composer require phpnomad/json-schema
```

You will also need a concrete implementation package. The canonical one is [`phpnomad/opis-json-schema-integration`](https://github.com/phpnomad/opis-json-schema-integration).

Usage
-----

[](#usage)

```
use PHPNomad\JsonSchema\Interfaces\JsonSchemaValidatorStrategy;
use PHPNomad\JsonSchema\Exceptions\ValidationError;

/** @var JsonSchemaValidatorStrategy $validator */
try {
    $validator->validate($data, '/path/to/schema.json');
    // Validation passed.
} catch (ValidationError $e) {
    foreach ($e->failures as $failure) {
        // $failure->path, $failure->message, $failure->keyword
    }
}
```

`validate()` returns `true` on success and throws `ValidationError` on failure. The exception carries the full collection of failures — one entry per violation — so callers can report every problem in a single pass rather than a fail-fast single message.

Contract
--------

[](#contract)

### `JsonSchemaValidatorStrategy`

[](#jsonschemavalidatorstrategy)

The single validation entry point. Implementations resolve `$schemaUri` (a file path, URL, or registered schema identifier) to a JSON Schema document and validate `$data` against it.

```
interface JsonSchemaValidatorStrategy
{
    /**
     * @throws ValidationError When validation fails.
     */
    public function validate(array $data, string $schemaUri): bool;
}
```

### `ValidationError`

[](#validationerror)

Thrown on validation failure. Exposes a `readonly` collection of `ValidationFailure`.

```
final class ValidationError extends \Exception
{
    /** @var ValidationFailure[] */
    public readonly array $failures;
}
```

### `ValidationFailure`

[](#validationfailure)

A single violation. All fields are `readonly` promoted properties.

```
final class ValidationFailure
{
    public readonly string $path;     // pointer to the offending location, e.g. "programs.gold.incentiveType"
    public readonly string $message;  // human-readable description
    public readonly string $keyword;  // JSON Schema keyword that failed — "type", "required", "enum", etc.
}
```

Why an abstraction
------------------

[](#why-an-abstraction)

Recipe importers, configuration validators, and schema-driven APIs are natural places to want JSON Schema validation, but picking a specific library locks that choice into every consumer. This package lets your code depend on *the idea of validating against a JSON Schema* without caring which library actually does the work — swap implementations for performance, draft support, or licensing reasons without touching downstream code.

License
-------

[](#license)

[MIT](LICENSE.txt)

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance90

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

51d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9e6206223bd6f2a57b8ac80605b1b5c3521faaec18ad3f20f25fb728a9a13784?d=identicon)[tstandiford](/maintainers/tstandiford)

---

Top Contributors

[![alexstandiford](https://avatars.githubusercontent.com/u/8210827?v=4)](https://github.com/alexstandiford "alexstandiford (1 commits)")

---

Tags

abstractionjson-schemaphpphpnomadvalidationvalidationjson-schemaabstractioninterfacephpnomad

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/phpnomad-json-schema/health.svg)

```
[![Health](https://phpackages.com/badges/phpnomad-json-schema/health.svg)](https://phpackages.com/packages/phpnomad-json-schema)
```

###  Alternatives

[opis/json-schema

Json Schema Validator for PHP

64841.2M257](/packages/opis-json-schema)[propaganistas/laravel-phone

Adds phone number functionality to Laravel based on Google's libphonenumber API.

3.0k38.3M138](/packages/propaganistas-laravel-phone)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)