Merge pull request #7 from WonderNetwork/feature/input-deserializer

input deserializer

Author: mlebkowski

.github/workflows/ci.yml

@@ -9,7 +9,7 @@ jobs:
   build:
     strategy:
       matrix:
-        php_version: ['7.4', '8.3']
+        php_version: ['8.3']
     runs-on: ubuntu-latest
 
     steps:

Readme.md

@@ -264,3 +264,23 @@ The output will be silenced except for the following situatios:
 
 In the former case, the output will be written in realtime, and in the two
 latter ones you can expect it writtein in bulk at the end.
+
+
+## Input parsing 
+
+In order to simplify input parsing, you can use the Symfony Serializer component to 
+automatically denormalize parsed request body or get params to a data transfer object
+of your choice. In your controller, simply mark one of the parameters with `#[Payload]`
+attribute and typehint it with your desired class:
+
+```php
+public function __invoke(#[WonderNetwork\SlimKernel\Http\Serializer\Payload] MyDto $input) {}
+```
+
+If the serializer fails to denormalize the input, a HttpBadRequestException will be
+thrown with a semi-helpful message attached. If you require custom serializer setup,
+you can register your own instance using the following container key:
+
+```
+\WonderNetwork\SlimKernel\ServiceFactory\SlimServiceFactory::INPUT_DENORMALIZER
+```

composer.json

@@ -2,15 +2,19 @@
     "name": "wondernetwork/slim-kernel",
     "type": "library",
     "require": {
-        "php": "^7.4|^8.0",
+        "php": ">=8.3",
         "ext-json": "*",
         "slim/slim": "^4.14",
         "slim/psr7": "^1.6",
         "php-di/php-di": "^6.4",
         "dusank/knapsack": "^10.0",
         "php-di/slim-bridge": "^3.4",
         "symfony/console": "^5.4",
-        "symfony/finder": "^5.4"
+        "symfony/finder": "^5.4",
+        "symfony/property-access": "^7.2",
+        "symfony/serializer": "^7.2",
+        "phpstan/phpdoc-parser": "^2.0",
+        "phpdocumentor/reflection-docblock": "^5.6"
     },
     "license": "MIT",
     "autoload": {