JsonApiClient

JsonApiClient is a PHP Library to validate and handle the response body from a JSON API Server.

Attention

Version 0.5 and below interprets the pagination links wrong. Make sure you are using the latest version of JsonApiClient. See issue #19 for more information.

WIP: Goals for 1.0

Be 100% JSON API 1.0 spec conform
Handle/validate a server response body
Offer an easy way to retrieve the data
Be extendable and allow injection of classes/models
Offer access to included resources through identifier
Handle/validate a client request body

Install

Via Composer

$ composer require art4/json-api-client

Usage

See the documentation.

Using as reader

// The Response body from a JSON API server
$jsonapi_string = '{"meta":{"info":"Testing the JsonApiClient library."}}';

$manager = new \Art4\JsonApiClient\Utils\Manager();

$document = $manager->parse($jsonapi_string);

if ($document->has('meta.info'))
{
    echo $document->get('meta.info'); // "Testing the JsonApiClient library."
}

// List all keys
var_dump($document->getKeys());

// array(
//   0 => "meta"
// )

Using as validator

JsonApiClient can be used as a validator for JSON API contents:

$wrong_jsonapi = '{"data":{},"meta":{"info":"This is wrong JSON API. `data` has to be `null` or containing at least `type` and `id`."}}';

if ( \Art4\JsonApiClient\Utils\Helper::isValid($wrong_jsonapi) )
{
	echo 'string is valid.';
}
else
{
	echo 'string is invalid json api!';
}

// echos 'string is invalid json api!'

Extend the client

Need more functionality? Want to directly inject your model? Easily extend JsonApiClient with the Factory.

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ phpunit

Contributing

Please feel free to fork and sending Pull Requests. This project follows Semantic Versioning 2.

Credits

License

GPL2. Please see License File for more information.

spartaksun/json-api-client