juststeveking / laravel-data-object-tools
A set of tools to make working with Data Transfer Objects easier in Laravel
Installs: 8 494
Dependents: 2
Suggesters: 0
Security: 0
Stars: 64
Watchers: 4
Forks: 8
Open Issues: 1
Requires
- php: ^8.1
- eventsauce/object-hydrator: ^0.4.3
- illuminate/contracts: ^9.22|^10.0|^11.0
- illuminate/support: ^9.22|^10.0|^11.0
Requires (Dev)
- laravel/pint: ^1.1
- orchestra/testbench: ^7.6
- pestphp/pest: ^1.21
- phpstan/phpstan: ^1.8
README
This package is aimed to be a suite of tools to help working with DTOs even easier. It includes an artisan command to generate DTOs as well as a facade to help you hydrate them.
Installation
composer require juststeveking/laravel-data-object-tools
Usage
To generate a new DTO all you need to do is run the following artisan command:
php artisan make:dto MyDto
This will generate the following class: app/DataObjects/MyDto.php
. By default this class
will be a final
class that implements a DataObjectContract
which enforces a method toArray
so that you can
easily cast your DTOs to arrays.
If you are using PHP 8.2 however, you will by default get a readonly
class generated, so that you do not have
to declare each property as readonly.
To work with the hydration functionality you can either use Laravels DI container, or the ready made facade.
Using the container:
class StoreController { public function __construct( private readonly HydratorContract $hydrator, ) {} public function __invoke(StoreRequest $request) { $model = Model::query()->create( attributes: $this->hydrator->fill( class: ModelObject::class, parameters: $request->validated(), )->toArray(), ); } }
To work with the facade, you can do something very similar:
class StoreController { public function __invoke(StoreRequest $request) { $model = Model::query()->create( attributes: Hydrator::fill( class: ModelObject::class, parameters: $request->validated(), )->toArray(), ); } }
Object Hydration
Under the hood this package uses an EventSauce package, created by Frank de Jonge. It is possibly the best package I have found to hydrate objects nicely in PHP. You can find the documentation here if you would like to see what else you are able to do with the package to suit your needs.
Testing
To run the test suite:
composer run test
Credits
LICENSE
The MIT License (MIT). Please see License File for more information.