adapterap/data-transfer-object

There is no license information available for the latest version (2.0.5) of this package.

Библиотека для конвертации массива в класс

2.0.5 2021-10-26 07:17 UTC

Requires

• php: >=7.4
• illuminate/container: ^7.0|^8.0
• illuminate/database: ^7.0|^8.0
• illuminate/support: ^7.0|^8.0
• myclabs/php-enum: ^1.8

Requires (Dev)

• phpunit/phpunit: ^9.2

Unknown License

• ADAPTERAP

README

Библиотека предоставляет возможность конвертировать массивы в объекты для дальнейшего использования типизации

Пример использования

use Adapterap\DataTransferObject\Attributes\EntityPropertyIsLazy;
use Adapterap\DataTransferObject\Attributes\EntityPropertyIsNotRequired;
use Adapterap\DataTransferObject\Attributes\EntityPropertyExcludedFromArray;
use Adapterap\DataTransferObject\Entity;

class SomeEntity extends Entity {
    /**
     * Поле, обязательное для заполнения.
     * 
     * @var int 
     */
    public int $requiredValue;
    
    /**
     * Не обязательное поле со значением по умолчанию.
     * 
     * @var int 
     */
    public int $defaultValue = 0;
    
    /**
     * Не обязательное поле.
     * 
     * @var int 
     */
    #[EntityPropertyIsNotRequired]
    public int $notRequiredValue;
    
    /**
     * Поле, которое можно не заполнять сразу, и заполнить позднее.
     * 
     * @var int 
     */
    #[EntityPropertyIsLazy]
    public int $lazyValue;
    
    /**
     * Поле, которое не будет включено в результирующий массив.
     * 
     * @var int 
     */
    #[EntityPropertyExcludedFromArray]
    public int $excludedValue;
}

$entity = new SomeEntity([
    'requiredValue' => 1,
]);

if ($entity->exists('notRequiredValue')) {
    // Поле $entity->notRequiredValue заполнено
}

// Динамическое заполнение
$entity->defaultValue = 1;
// или
$entity->fill(['defaultValue' => 1]);

$entity->toArray(); // [
                    //      'requiredValue' => ...,
                    //      'defaultValue' => ...,
                    //      'notRequiredValue' => ...,
                    //      'lazyValue' => ...,
                    // ];

TODO

• Добавить атрибут для финального формата даты в toArray()
• Добавить атрибут для изменения наименования атрибута (в snack, в camel, в custom)