2017 © Pedro Peláez
 

library bindto

Simple way to bind Request to DTO/Commands

image

pugx/bindto

Simple way to bind Request to DTO/Commands

  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 6 Forks
  • 5 Open issues
  • 5 Versions
  • 5 % Grown

The README.md

Bindto

Simplest way to bind Request to DTO/Commands.

Bindto helps you to work with API and data validation using DTO and Commands., (*1)

Is really fast (it doesn't use Reflection) and binds the Request against your class., (*2)

It's the smartest way to stop using the slow and complex Symfony Form component for API., (*3)

Install

composer require pugx/bindto, (*4)

Usage

Example, you have to create a Post/Patch/Put Api, (*5)

1. Create a simple class that is the body of a request

protip: you can use with Symfony validation component annotations

``` php, (*6)

use Symfony\Component\Validator\Constraints as Assert;, (*7)

Class CreateFeedback {, (*8)

/**
 * @Assert\NotBlank(groups={"POST"})
 * @Assert\Type(type="string")
 */
public $subject;

/**
 * @Assert\NotNull(groups={"POST"})
 * @Assert\Type(type="string")
 * @Assert\Length(
 *      min = 10,
 *      max = 500)
 */
public $body;

}, (*9)


### 2. In your controller

if you use Silex you may want to enforce the input validation,
improving the example at http://silex.sensiolabs.org/doc/usage.html#example-post-route:

``` php

require_once __DIR__.'/../vendor/autoload.php';

use Bindto\Binder;

$app = new Silex\Application();

$app->post('/feedback', function (Request $request) {

    $binder = Binder::createSimpleProductionBinder();
    $result = $binder->bind($request, CreateFeedback::class);
    if (!$result->isValid()) {
        throw new \Exception($result->getViolations());
    }
    $createFeedBack = $result->getData();
    mail($createFeedBack->subject, '[YourSite] Feedback', $createFeedBack->body);

    return new Response('Thank you for your feedback!', 201);
});

$app->run();

PATCH support with partial modification

Use the validation groups if you want to PATCH partially:, (*10)

``` php /** * @Assert\NotNull(groups={"POST"}) * @Assert\Type(type="string") * @Assert\Length( * min = 10, * max = 500) */ public $body;, (*11)


With a POST request all the assertions will be used,
with a PUT and PATCH only the `Type` and `Length` assertions.


## TODO

- recursive binder?
- collection?
- twig helper?
- tests decouple maptest from bindertest
- silex provider?
- sf bundle?

## Run tests

``` bash
composer dump-autoload
bin/phpunit

The Versions

31/05 2016

dev-master

9999999-dev

Simple way to bind Request to DTO/Commands

  Sources   Download

MIT

The Requires

 

The Development Requires

by Giulio De Donato
by Simone Di Maulo

21/04 2016

v0.1.1

0.1.1.0

Simple way to bind Request to DTO/Commands

  Sources   Download

MIT

The Requires

 

The Development Requires

by Giulio De Donato
by Simone Di Maulo

20/04 2016

v0.1.0

0.1.0.0

Simple way to bind Request to DTO/Commands

  Sources   Download

MIT

The Requires

 

The Development Requires

by Giulio De Donato
by Simone Di Maulo

18/09 2015

dev-liuggio-patch-1

dev-liuggio-patch-1

  Sources   Download

The Requires

 

The Development Requires

by Giulio De Donato
by Simone Di Maulo

07/07 2015

dev-fix-to-reference

dev-fix-to-reference

  Sources   Download

The Requires

 

The Development Requires

by Giulio De Donato
by Simone Di Maulo