PHPackages ccharz/laravel-dto-lite - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. ccharz/laravel-dto-lite ActiveLibrary[Utility & Helpers](/categories/utility) ccharz/laravel-dto-lite ======================= Simple Laravel Data Transfer Object v3.9.0(1mo ago)02.2kMITPHPPHP ^8.2CI passing Since Mar 29Pushed 1mo ago1 watchersCompare [ Source](https://github.com/ccharz/laravel-dto-lite)[ Packagist](https://packagist.org/packages/ccharz/laravel-dto-lite)[ RSS](/packages/ccharz-laravel-dto-lite/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (10)Versions (23)Used By (0) Laravel Data Transfer Object Lite ================================= [](#laravel-data-transfer-object-lite) This is a basic implementation of the data transfer object (DTO) concept. The idea is to describe input and output of data in one simple basic php class file. It is meant to replace FormRequests and Resources and can also be used to automatically generate typescript definitions. This package is similar to the [Laravel Data](https://spatie.be/docs/laravel-data) Package from Spatie. The main difference it contains no reflection class magic and only provides the basic functionalities. Installation ------------ [](#installation) ``` composer require ccharz/laravel-dto-lite ``` Usage ----- [](#usage) ### Example DTO [](#example-dto) ``` enum ContactType : string { case PERSON = 'person'; case COMPANY = 'company'; } readonly class ContactData extends DataTransferObject { public function __construct( public string $name, public string $email, public ContactType $type, ) {} } ``` ### Casts [](#casts) Casts for attributes can be defined similar to eloquent casts. It is also possible to define casts to an array ``` enum ContactType : string { case PERSON = 'person'; case COMPANY = 'company'; } readonly class AddressData extends DataTransferObject { public function __construct( public ?string $country = null, public ?string $zip = null, public ?string $location = null, public ?string $street = null, public ?string $streetnumber = null, public ?string $stair = null, public ?string $top = null, ) { } } readonly class ContactData extends DataTransferObject { public function __construct( /** @var AddressData[] $addresses */ public array $addresses, public DateTime $birthday, public ContactType $type, ) {} public static function casts(): array { return [ 'addresses' => AddressData::class . '[]', 'birthday' => 'datetime', 'type' => ContactType::class, ]; } } ``` ### Validation [](#validation) If a rules method exists, validation is automatically performed when creating a DTO from a request manually or by automatic dependency injection. ``` use Illuminate\Http\Request; public static function rules(?Request $request = null): ?array { return ['prename' => 'min:2']; } ``` You can also inject the rules from casts in your rules: ``` use Illuminate\Http\Request; public static function rules(?Request $request = null): ?array { return [ ...parent::castRules(), ]; } ``` ### Automatic Injection [](#automatic-injection) With the help if laravels dependency injection, the dto can be used in a controller method function and is automatically filled with the **validated** input data from the request. ``` public function store(ContactData $contactData): RedirectResponse { Contact::create([ 'name' => $contactData->name, 'email' => $contactData->email, ]); return redirect()->back(); } ``` ### Eloquent Castable [](#eloquent-castable) DataTransferObjects can be used as a cast in eloquent models ``` class Contact extends Model { protected $casts = [ 'address' => AddressData::class, ]; } ``` If the column is nullable, you have to append the cast parameter "nullable": ``` class Contact extends Model { protected $casts = [ 'address' => AddressData::class . ':nullable', ]; } ``` Casting arrays of Data Transfer Objects: ``` use Ccharz\DtoLite\AsDataTransferObjectCollection; /** * Get the attributes that should be cast. * * @return array */ protected function casts(): array { return [ 'addresses' => AsDataTransferObjectCollection::of(AddressData::class), ]; } ``` ### Response [](#response) Data Transfer Objects are automatically converted to an response if returned from a controller ``` class ContactController extends Controller { public function show(Contact $contact): ContactData { return ContactData::make($contact); } } ``` You can also return a [resource collection](https://laravel.com/docs/11.x/eloquent-resources#resource-collections) of data transfer objects ``` class ContactController extends Controller { public function index() { return ContactData::resourceCollection(Contact::paginate()); } } ``` ### Map to DTO Array [](#map-to-dto-array) An array can automatically be mapped to an array of the DTO: ``` $addresses = [ [ 'country' => 'AT', 'zip' => '8010', ], [ 'country' => 'AT', 'zip' => '8010', ] ]; AddressData::mapToDtoArray($addresses); ``` Typescript Definitions ---------------------- [](#typescript-definitions) You can use to automatically generate typescript definitions for your Data Transfer Objects and Enums. ``` namespace App\Data; use Spatie\TypeScriptTransformer\Attributes\TypeScript; #[TypeScript] readonly class AddressData extends DataTransferObject { public function __construct( public readonly ?string $country = null, public readonly ?string $zip = null, public readonly ?string $location = null, public readonly ?string $street = null, public readonly ?string $streetnumber = null, public readonly ?string $stair = null, public readonly ?string $top = null, ) { } } ``` generates to the following typescript definition: ``` declare namespace App.Data { export type AddressData = { country: string | null; zip: string | null; location: string | null; street: string | null; streetnumber: string | null; stair: string | null; top: string | null; }; } ``` Artisan Command --------------- [](#artisan-command) To create a new data transfer object, use the make:dto Artisan command: ``` php artisan make:dto Address ``` ### Health Score 48 — FairBetter than 94% of packages Maintenance89 Actively maintained with recent releases Popularity20 Limited adoption so far Community7 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~42 days Recently: every ~105 days Total 18 Last Release 56d ago Major Versions v1.3.0 → v2.0.02024-07-11 v2.0.0 → v3.0.02024-07-16 ### Community Maintainers ![](https://www.gravatar.com/avatar/ab9470e53a3c1c9a6654c0c049eae5eb9901beeeeb8f63f18292e4ad14d068e2?d=identicon)[ccharz](/maintainers/ccharz) --- Top Contributors [![ccharz](https://avatars.githubusercontent.com/u/2725238?v=4)](https://github.com/ccharz "ccharz (33 commits)") --- Tags laraveldto ### Code Quality Static AnalysisPHPStan, Rector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/ccharz-laravel-dto-lite/health.svg) ``` [![Health](https://phpackages.com/badges/ccharz-laravel-dto-lite/health.svg)](https://phpackages.com/packages/ccharz-laravel-dto-lite) ``` ### Alternatives [livewire/volt An elegantly crafted functional API for Laravel Livewire. 4195.3M84](/packages/livewire-volt)[whitecube/laravel-timezones Store UTC dates in the database and work with custom timezones in the application. 106106.2k](/packages/whitecube-laravel-timezones)[forxer/laravel-gravatar A library providing easy gravatar integration in a Laravel project. 4235.6k](/packages/forxer-laravel-gravatar)[iteks/laravel-enum A comprehensive Laravel package providing enhanced enum functionalities, including attribute handling, select array conversions, and fluent facade interactions for robust enum management in Laravel applications. 2516.7k](/packages/iteks-laravel-enum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)