Allows you to pass data in the specified typing, namely in
IsakzhanovR\ValueObject
or in a primitive type. The same type can be a DTO
To get the latest version of Laravel Data Transfer Object package, simply require the project using Composer:
$ composer require isakzhanov-r/laravel-dto
Instead, you can, of course, manually update the dependency block require
in composer.json
and run composer update
if you want to:
{
"require-dev": {
"isakzhanov-r/laravel-dto": "^1.0"
}
}
To use DTO
, you need to create a class that will inherit from the abstract DataTransferObject class, and declare the public variables in the class with the
desired type
use IsakzhanovR\DataTransferObject\DataTransferObject;
use IsakzhanovR\ValueObject\Email // example
class UserData extends DataTransferObject
{
public $id;
public string $name;
/**
* @var \IsakzhanovR\ValueObject\Email
* @throws \App\Exceptions\EmailDataExeption
*/
public Email $email;
/**
* @var IsakzhanovR\DataTransferObject\FiledDTO[] - example
*/
public array $fields;
}
You can also create a DTO object from an array, from a FormRequest, from an Object and from a JSON string
$dto = new UserData(['id' => 1,'name' => 'Example',' email' => 'example@test.com']);
$array = ['id' => 1,'name' => 'Example',' email' => 'example@test.com'];
$dto = UserData::fromArray($array);
$object = new stdClass();
$object->id = 1;
$object->name = 'Example';
$object->email = 'example@test.com';
$dto = UserData::fromObject($object);
$dto = UserData::fromRequest($request);
$dto = UserData::fromJson(json_encode($array));
It also happens that you need to reverse transformation into an array , for this there is a get
method:
$dto->get()
or a method with recursive transformation into an array
$dto->toArray()
This package is released under the MIT License.