We’ve released a new major version of spatie/data-transfer-object. This package makes it easy to create objects that have a certain shape. Properties can even be validated.
ð Need self-validating PHP objects? Here you go!https://t.co/osPCSr0qu8
Gotta love PHP 8
Very nice work by @brendt_gd pic.twitter.com/Sn1mS7R8Sv
— Freek Van der Herten ð (@freekmurze) April 2, 2021
In this post I’d like to tell you more the package.
A modern package to construct data transfer objects #
When we original released the data-transfer-object package, it was meant to solve four problems:
- Runtime type checks for class properties
- Support for union types
- Support for array types (these are not full blown generics!)
- Named arguments
Typed properties are added in PHP 7.4, and union types and named arguments in PHP 8. So now that PHP 8 has been released, it makes sense that we leverage PHP’s native type check abilities.
The renewed goal of our package is to make constructing objects from arrays of (serialized) data as easy as possible. Here’s what a DTO looks like:
}
You could construct this DTO like so:
Let’s discuss all possibilities one by one.
Named arguments #
Constructing a DTO can be done with named arguments. It’s also possible to still use the old array notation. This example is equivalent to the one above.
Value casts #
If a DTO has a property that is another DTO or a DTO collection, the package will take care of automatically casting arrays of data to those DTOs:
Custom casters #
You can build your own caster classes, which will take whatever input they are given, and will cast that input to the desired result.
Take a look at the ComplexObject
:
And its caster ComplexObjectCaster
:
Class-specific casters #
Instead of specifying which caster should be used for each property, you can also define that caster on the target class itself:
Default casters #
It’s possible to define default casters on a DTO class itself. These casters will be used whenever a property with a given type is encountered within the DTO class.
}
Validation #
This package doesn’t offer any specific validation functionality, but it does give you a way to build your own validation attributes. For example, NumberBetween
is a user-implemented validation attribute:
It works like this under the hood:
}
In closing #
We use spatie/data-transfer-object in our bigger projects. We hope that this package can be handy for you as well. The package has a few more features, to learn them, head over to the readme on GitHub.
The principal author of this package is my colleague Brent, who, like always, did an excellent job.
Want to see more packages that our team has created? Head over to the open source section on spatie.be