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

Format: JSON API 1.0

• ✔️ Be 100% JSON API spec conform
• ✔️ Be open for new spec versions
• ✔️ Handle/validate a server response body
• ✔️ Handle/validate a client request body
• ✔️ Offer an easy way to retrieve the data
• ✔️ Allow extendability and injection of classes/models

Via Composer

$ composer require art4/json-api-client

JsonApiClient can be considered as stable and version 0.10 will be the last development version.

After version 0.8 there where no breaking changes. Every change was backward compatible and every functionality that will be removed in future now only triggers a deprecated warning.

After version 0.10 is released all deprecated code will be removed and version 1.0 will be released.

This simply means for you:

1. Update to version 0.10
2. Make your code deprecation free
3. You are now ready for upgrading to version 1.0 without breaking your code

(Compare the Symfony upgrade documentation)

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

See the quickstart guide or the documentation.

use Art4\JsonApiClient\Exception\InputException; use Art4\JsonApiClient\Exception\ValidationException; use Art4\JsonApiClient\Helper\Parser; // The Response body from a JSON API server $jsonapiString = '{"meta":{"info":"Testing the JsonApiClient library."}}'; try { // Use this if you have a response after calling a JSON API server $document = Parser::parseResponseString($jsonapiString); // Or use this if you have a request to your JSON API server $document = Parser::parseRequestString($jsonapiString); } catch (InputException $e) { // $jsonapiString is not valid JSON } catch (ValidationException $e) { // $jsonapiString is not valid JSON API }

Note: Using Art4\JsonApiClient\Helper\Parser is just a shortcut for directly using the Manager.

$document implements the Art4\JsonApiClient\Accessable interface to access the parsed data. It has the methods has($key), get($key) and getKeys().

// Note that has() and get() have support for dot-notated keys if ($document->has('meta.info')) { echo $document->get('meta.info'); // "Testing the JsonApiClient library." } // you can get all keys as an array var_dump($document->getKeys()); // array( // 0 => "meta" // )

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

use Art4\JsonApiClient\Helper\Parser; $wrong_jsonapi = '{"data":{},"meta":{"info":"This is wrong JSON API. `data` has to be `null` or containing at least `type` and `id`."}}'; if ( Parser::isValidResponseString($wrong_jsonapi) ) { // or Parser::isValidRequestString($wrong_jsonapi) echo 'string is valid.'; } else { echo 'string is invalid json api!'; } // echoes 'string is invalid json api!'

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

Please see CHANGELOG for more information what has changed recently.

$ phpunit

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

• Artur Weigandt
• All Contributors

GPL3. Please see License File for more information.