estahn/phpunit-json-assertions

JSON assertions for PHPUnit (including JSON Schema)

phpunit-json-assertions

, _(*1)

JSON assertions for PHPUnit includes traits/methods to help validate your JSON data through various methods., _(*2)

Features

• Validate your JSON data via JSON Schema
  • describes your existing data format
  • clear, human- and machine-readable documentation
  • complete structural validation, useful for
    • automated testing
    • validating client-submitted data
  • See more details here
• Access JSON data through expressions (e.g. foo.bar[3])
  • See more details here

Install

$ composer require estahn/phpunit-json-assertions --dev

or in your composer.json:, _(*3)

{
    "require-dev": {
        "estahn/phpunit-json-assertions": "@stable"
    }
}

Asserts

Usage

You can either use the trait or class version., _(*4)

Trait

<?php

namespace EnricoStahn\JsonAssert\Tests;

use EnricoStahn\JsonAssert\Assert as JsonAssert;

class MyTestCase extends \PHPUnit_Framework_TestCase
{
    use JsonAssert;

    public function testJsonDocumentIsValid()
    {
        // my-schema.json
        //
        // {
        //   "type" : "object",
        //   "properties" : {
        //     "foo" : {
        //       "type" : "integer"
        //     }
        //   },
        //   "required" : [ "foo" ]
        // }

        $json = json_decode('{"foo":1}');

        $this->assertJsonMatchesSchema($json, './my-schema.json');
        $this->assertJsonValueEquals(1, '* | [0]', $json);
    }
}

Class

In case you don't want to use the trait you can use the provided class wich extends from \PHPUnit_Framework_TestCase. You can either extend your test case or use the static methods like below., _(*5)

<?php

namespace EnricoStahn\JsonAssert\Tests;

use EnricoStahn\JsonAssert\AssertClass as JsonAssert;

class MyTestCase extends \PHPUnit_Framework_TestCase
{
    public function testJsonDocumentIsValid()
    {
        // my-schema.json
        //
        // {
        //   "type" : "object",
        //   "properties" : {
        //     "foo" : {
        //       "type" : "integer"
        //     }
        //   },
        //   "required" : [ "foo" ]
        // }

        $json = json_decode('{"foo":1}');

        JsonAssert::assertJsonMatchesSchema($json, './my-schema.json');
        JsonAssert::assertJsonValueEquals(1, '* | [0]', $json);
    }
}

Schema storage

The schema storage of justinrainbow/json-schema allows to register schemas which will effectively override the actual schema location., _(*6)

Example:, _(*7)

{"$ref" : "https://iglu.foobar.com/myschema.json#/definitions/positiveInteger"}

The resolver will fetch the schema from this endpoint and match the JSON document against it. Using schema storage you're able to override this behaviour., _(*8)

$schemastorage->addSchema('https://iglu.foobar.com/myschema.json', (object)['type' => 'string']);

With this in place the resolver will take the schema that is already in place without downloading it again., _(*9)

<?php

namespace EnricoStahn\JsonAssert\Tests;

use EnricoStahn\JsonAssert\AssertClass as JsonAssert;

class MyTestCase extends \PHPUnit_Framework_TestCase
{
    public function setUp()
    {
        self::$schemaStorage = new SchemaStorage();

        self::$schemaStorage->addSchema('<id>', obj);
        ...
    }

    public function testJsonDocumentIsValid()
    {
        // my-schema.json
        //
        // {
        //   "type" : "object",
        //   "properties" : {
        //     "foo" : {
        //       "type" : "integer"
        //     }
        //   },
        //   "required" : [ "foo" ]
        // }

        $json = json_decode('{"foo":1}');

        JsonAssert::assertJsonMatchesSchema($json, './my-schema.json');
        JsonAssert::assertJsonValueEquals(1, '* | [0]', $json);
    }
}

Extensions

phpunit-json-assertions provides extensions for simpler handling in different use cases., _(*10)

Symfony HttpFoundation Component

The extension EnricoStahn\JsonAssert\Extension\Symfony allows to pass in the actual response object generated by the symfony framework and takes care of the decoding part., _(*11)

BEFORE:, _(*12)

use EnricoStahn\JsonAssert\Assert as JsonAssert;

// ...

$content = $response->getContent();
$json = json_decode($content);
JsonAssert::assertJsonMatchesSchemaString('./my-schema.json', $json);

AFTER:, _(*13)

use EnricoStahn\JsonAssert\Extension\Symfony as JsonAssert;

// ...

JsonAssert::assertJsonMatchesSchemaString('./my-schema.json', $response);

Tests

To run the test suite, you need composer., _(*14)

$ composer install
$ bin/phpunit

Badge Mania

, _(*15)

Alternatives

• https://github.com/martin-helmich/phpunit-json-assert - Doesn't support JSON Schema and uses JSONPath instead of jmespath.php

License

The phpunit-json-assertions library is licensed under the MIT., _(*16)

Stargazers over time

, _(*17)