Request data bundle

This bundle allows you to represent request data in a structured and useful way by creating request data classes.

Features:

Detecting how to extract data depends on request method and Content-Type header.
Representing and normalizing query parameters for the GET request method.
Representing form, json, xml request body for the POST, PUT, PATCH request methods.
Dispatching the finish event when request data is ready.

Installation

Run the following command using Composer:

composer require bilyiv/request-data-bundle

Configuration

The default configuration is the following:

request_data:
    prefix: App\RequestData

Usage

Create a request data class

namespace App\RequestData;

class PostRequestData
{
    public const DEFAULT_AUTHOR = 'none';

    /**
     * @var string
     */
    public $title;

    /**
     * @var string
     */
    public $author = self::DEFAULT_AUTHOR;
}

Use it in your controller

namespace App\Controller;

class PostController extends AbstractController
{
    /**
     * @Route("/", name="action")
     */
    public function action(PostRequestData $data)
    {
       return new JsonResponse($data);
    }
}

Make requests

All the following requests will return the same response {"title":"It works","author":"Vlad"}:

curl -X GET 'http://localhost:8000?title=It+works&author=Vlad'

curl -X POST 'http://localhost:8000' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
     -d 'title=It+works&author=Vlad'

curl -X POST 'http://localhost:8000' \
     -H 'Content-Type: application/json' \
     -d '{"title":"It works","author":"Vlad"}'

curl -X POST 'http://localhost:8000' \
     -H 'Content-Type: application/xml' \
     -d '<post><title>It works</title><author>Vlad</author></post>'

License

This bundle is released under the MIT license. See the included LICENSE file for more information.

hermann8u/request-data-bundle