Download the PHP package gepur-it/request-converter-bundle without Composer
On this page you can find all versions of the php package gepur-it/request-converter-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package request-converter-bundle
Request convertion and validation bundle
[TOC]
About
This bundle allow to easy map incoming request to defined DTO and validate it before controller starts works
Documentation
installation
to install converter, use composer
how to use
at first, create your own request DTO model with validation rules
request model
then declare model using via @RequestDTO annotation in your controller
controller
change function argument name
by default, requestModel argument name called 'requestModel', you can change it, defined 'name' parameter in annotatnion
disable validation
to disable request validation, set "validate" annotation parameter to false
annotaion parameters
- model - contains class name of request`s model class, required
- name - contains argument`s name for controller method, by default "requestModel"
- validate - shouls request be validated before action. by default false.
post-construction handling
you can calculate some additional params to validate after request constructed.
example: request has two integer parameters, but you need to validate custom rule - sum of that parameters should not be greated than 10.
interface implementation
at first, implement "GepurIt\RequestConverterBundle\Contract\RequestModelServiceInterface interface" on your request model,
custom fields handling
as you see, RequestModelServiceInterface provides "handle" method. this method will be called immediately after request model construction. so, you can add your custom field with validation rules, and calculate they in "handle()" method
Dependency injection
for use dependency injection in your request, think twice
if you steel need dependency injection, think more times, maybe, you need just a custom validation?
But if you shure, you really need dependency in your request model, so you can define it as container service
⚠️ Warning: Do not use any domain logic or buisness here, is need only for validation
- Request model Services MUST implemets RequestModelServiceInterface
- to register this service in converter, tag it with 'request_model_service' tag
implement interface and dependencies
register this service in converter
All versions of request-converter-bundle with dependencies
ext-json Version *
symfony/http-kernel Version ^5.0
symfony/console Version ^5.0
doctrine/annotations Version >=1.6
symfony/validator Version ^5.0
symfony/property-access Version ^5.0
symfony/dependency-injection Version ^5.0
symfony/config Version ^5.0