Download the PHP package ideneal/request-content-converter-bundle without Composer

IdenealRequestContentConverterBundle

This is a Symfony bundle that extends the features of SensioFrameworkExtraBundle. It provides a way to deserialize and validate the request content into a specified class or entity.

Installation

Add the bundle to your composer.json file:

Usage

ContentParamConverter

The ContentParamConverter permits you to convert the request content into a specific controller action parameter.

Let's see a simple use case where you want to subscribe a lead. Create a simple Lead class:

Inside the controller create a simple action and add the ContentParamConverter annotation specifying the request format:

In this case the annotation ContentParamConverter automatically maps the request content json keys into related Lead properties and validate it.

You could also use as well Json and Xml without set the format instead of ContentParamConverter.

EntityContentParamConverter

In order to map the request content to a Doctrine entity you could use EntityContentParamConverter. You could also use JsonEntity and XmlEntity where the format has been specified.

Let's see a use case where you have to update a product in db. So you have an entity Product.

In order to update a specific Product you could create the following action:

Within controller action the $product has just been updated and validated by the json request.

Annotation Options

In addiction to format parameter you could set other options.

groups

Sometimes, you want to deserialize different sets of attributes from your selected class. Groups are a handy way to achieve this need.

The value of the groups key can be a single string, or an array of strings.

validate

Default is true. If false the validation will be disabled.

validation_groups

By default, all constraints of selected class will be checked whether or not they actually pass. In some cases, however, you will need to validate an object against only some constraints on that class. To do this, you can organize each constraint into one or more "validation groups" and then apply validation against just one group of constraints.