Download the PHP package yorcreative/laravel-argonaut-dto without Composer
On this page you can find all versions of the php package yorcreative/laravel-argonaut-dto. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download yorcreative/laravel-argonaut-dto
More information about yorcreative/laravel-argonaut-dto
Files in yorcreative/laravel-argonaut-dto
Package laravel-argonaut-dto
Short Description Argonaut is a lightweight Data Transfer Object (DTO) package for Laravel that supports nested casting, recursive serialization, and validation out of the box. Ideal for service layers, APIs, and clean architecture workflows.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-argonaut-dto
Laravel Argonaut DTO
Laravel Argonaut DTO is a lightweight, highly composable package for transforming arrays, objects, or collections into structured DTOs (Data Transfer Objects), with built-in support for:
- 🧱 Deep nested transformation and casting
- 🔁 Type-safe data conversion
- ✅ Validation using Laravel’s validator
- 🧠 Explicit attribute prioritization
- 📦 Clean serialization (
toArray,toJson) - ♻️ Consistent data shape enforcement across boundaries
📦 Installation
Install via Composer:
🚀 Quick Start
1. Define a DTO
DTOs extend ArgonautDTO, and define your expected structure via public properties, casting rules, and validation.
This defines a strongly typed DTO with both validation rules and simple type casting.
2. Create an Assembler
Assemblers are responsible for mapping raw inputs (arrays or objects) into your DTOs.
Assembler method names must follow the format
to<ClassName>, and are resolved automatically usingclass_basename.
3. Assemble a DTO
Use the assembler to transform raw data into structured, casted DTO instances.
You can also batch transform arrays or collections:
🧪 Real-World Example: Product + Features + Reviews
This example demonstrates nested relationships and complex type casting in action.
ProductDTO with nested casting:
ProductDTOAssembler mapping input structure:
🎯 DTOs with Prioritized Attributes and Custom Setters
ArgonautDTO allows you to prioritize the assignment of specific fields using $prioritizedAttributes, which is critical for cases where one field influences others.
🔁 Casting Reference
Casting allows you to automatically transform values into other DTOs, Laravel Collections, arrays, dates, and more.
| Cast Type | Example | Description |
|---|---|---|
| Scalar | 'string', 'int', etc. |
Native PHP type cast |
| Single DTO | ProfileDTO::class |
Cast an array to a DTO instance |
| Array of DTOs | [RoleDTO::class] |
Cast to array of DTOs |
| Collection of DTOs | Collection::class . ':' . CommentDTO::class |
Cast to a Laravel Collection |
| Date casting | Carbon::class |
Cast to Carbon/DateTime instance |
✅ Validation
Validate DTOs with Laravel’s validator:
📤 Serialization
Serialize DTOs for output, API responses, etc.
🛠️ DTO Collection Helper
Create DTO collections directly:
🧪 Testing
Run the test suite using:
📚 Credits
- Yorda
- All Contributors
📃 License
This package is open-sourced software licensed under the MIT license.
