isakzhanov-r/laravel-dto

Laravel Data Transfer Object

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

Contents

• Installation
• Usage
• License

Installation

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"
    }
}

Usage

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()

License

This package is released under the MIT License.