Download the PHP package qbejs/laravel-dto-mapper without Composer
On this page you can find all versions of the php package qbejs/laravel-dto-mapper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download qbejs/laravel-dto-mapper
More information about qbejs/laravel-dto-mapper
Files in qbejs/laravel-dto-mapper
Package laravel-dto-mapper
Short Description Automatic DTO mapping for Laravel using PHP 8 Attributes
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-dto-mapper
📦 Laravel DTO Mapper
Automatic HTTP request mapping to DTO classes in Laravel using PHP 8 Attributes. A simple, clean, and type-safe way to handle validation and data mapping in your controllers.
✨ Features
- 🎯 PHP 8 Attributes - Clean and modern syntax
- ✅ Automatic Validation - Uses Laravel's built-in Validator
- 🔒 Type Safety - Full support for typed properties
- 📁 File Handling - Automatic
UploadedFilemapping - 📋 Arrays & Bulk Operations - Complete array mapping support
- 🚀 Zero Configuration - Works out-of-the-box with Package Discovery
- 🧪 Easy Testing - DTOs are simple PHP classes
📋 Requirements
- PHP 8.1 or higher
- Laravel 9.x, 10.x, 11.x, or 12.x
🔧 Installation
The Service Provider will be automatically registered via Laravel Package Discovery.
🚀 Quick Start
1. Create a DTO
2. Use in Controller
3. Done! 🎉
Your endpoint now:
- ✅ Automatically validates data
- ✅ Returns clear validation errors
- ✅ Maps data to type-safe DTO
- ✅ Is easy to test
📚 Documentation
Available Attributes
#[MapRequestPayload] - Request Body
Maps data from request body (POST/PUT/PATCH) to DTO.
Options:
validate: bool- Enable validation (default: true)stopOnFirstFailure: bool- Stop at first validation error (default: false)
Examples:
#[MapQueryString] - URL Parameters
Maps query string parameters (GET) to DTO.
File Handling
Single File Upload
Multiple File Uploads
Usage in Controller
Bulk Operations
Error Handling
When validation fails, a 422 response is returned:
🧪 Testing
💡 Best Practices
DTO Organization
Structure your DTOs by feature/entity:
Naming Conventions
- Create:
Create{Entity}DTO- for creating new resources - Update:
Update{Entity}DTO- for updating existing resources - Filter/Search:
{Entity}FilterDTO- for search parameters - Bulk:
Bulk{Action}{Entity}DTO- for bulk operations
Always Use Type Hints
DTOs Should NOT Have Constructors
🔍 Common Issues
Property must not be accessed before initialization
Problem: DTO property is not being populated.
Solution: Make sure:
- Property names match request parameter names (case-sensitive!)
- You're sending the parameter in the request
- For GET requests, use
#[MapQueryString] - For POST/PUT/PATCH, use
#[MapRequestPayload]
Unresolvable dependency
Problem: DTO has a constructor with parameters.
Solution: Remove the constructor. DTOs should only have public properties.
🤝 Contributing
Contributions are welcome! Please see CONTRIBUTING.md for details.
📄 Changelog
See CHANGELOG.md for recent changes.
📜 License
The MIT License (MIT). Please see License File for more information.
🙏 Credits
- Jakub Skowron
- All Contributors
💬 Support
⭐ Show Your Support
If this package helped you, please consider giving it a ⭐ on GitHub!
Made with ❤️ for the Laravel community
All versions of laravel-dto-mapper with dependencies
illuminate/support Version ^9.0|^10.0|^11.0|^12.0
illuminate/validation Version ^9.0|^10.0|^11.0|^12.0
illuminate/http Version ^9.0|^10.0|^11.0|^12.0
illuminate/routing Version ^9.0|^10.0|^11.0|^12.0