Update PHP requirements und docs

Author: Art4

README.md

@@ -21,7 +21,7 @@ Version 0.6.1 and below interprets the pagination links wrong. Make sure you are
 * [x] Offer an easy way to retrieve the data
 * [x] Be extendable and allow injection of classes/models
 * [ ] Offer access to included resources through identifier
-* [ ] Handle/validate a client request body
+* [x] Handle/validate a client request body
 
 ## Install
 
@@ -43,6 +43,9 @@ $jsonapi_string = '{"meta":{"info":"Testing the JsonApiClient library."}}';
 
 $manager = new \Art4\JsonApiClient\Utils\Manager();
 
+// Set this if you expect a resource creating request
+$manager->setConfig('optional_item_id', true);
+
 $document = $manager->parse($jsonapi_string);
 
 if ($document->has('meta.info'))

composer.json

@@ -13,7 +13,7 @@
         }
     ],
     "require": {
-        "php": "^5.4 || ^7.0"
+        "php": "^5.5 || ^7.0"
     },
     "require-dev": {
         "phpunit/phpunit": "^4.8.35 || ^6.0"

docs/utils-helper.md

@@ -21,6 +21,24 @@ This returns a [Document](objects-document.md) object which provided all content
 >
 > See more about Exceptions in the [Exception section](exception-introduction.md).
 
+### Parse a JSON API request body
+
+Assuming you have get a request for creating a new resource. In this case the `id` in the resource item can be missed and you have to tell the Manager about this case. Use `parseRequestBody()` to work with the data.
+
+```php
+
+// The requst body from a client
+$jsonapi_string = '{"data":{"type":"posts","attributes":{"title":"Post Title"}}}';
+
+$document = \Art4\JsonApiClient\Utils\Helper::parseRequestBody($jsonapi_string);
+```
+
+This returns a [Document](objects-document.md) object which provided all contents.
+
+> **Note:** If `$jsonapi_string` contains not valid JSON or JSON API a [Exception\ValidationException](exception-introduction.md#exceptionvalidationexception) will be thrown.
+>
+> See more about Exceptions in the [Exception section](exception-introduction.md).
+
 ### Validate a JSON API response body
 
 JsonApiClient can be used as a validator:

docs/utils-manager.md

@@ -21,6 +21,27 @@ This returns a [Document](objects-document.md) object which provided all content
 
 > **Note:** If `$jsonapi_string` contains not valid JSON or JSON API a [Exception\ValidationException](exception-introduction.md#exceptionvalidationexception) will be thrown.
 
+### Parse a JSON API string for creating a new resource
+
+Assuming you have get a request for creating a new resource. In this case the `id` in the resource item can be missed and you have to tell the Manager about this case.
+
+```php
+
+// The request body from a client
+$jsonapi_string = '{"data":{"type":"posts","attributes":{"title":"Post Title"}}}';
+
+$manager = new \Art4\JsonApiClient\Utils\Manager();
+
+// Set this to `true`
+$manager->setConfig('optional_item_id', true);
+
+$document = $manager->parse($jsonapi_string);
+```
+
+This returns a [Document](objects-document.md) object which provided all contents.
+
+> **Note:** If `$jsonapi_string` contains not valid JSON or JSON API a [Exception\ValidationException](exception-introduction.md#exceptionvalidationexception) will be thrown.
+
 ### Working with a factory
 
 You can set a custom [Factory](utils->factory.md) to the manager through `setFactory()` or the constructor.