It is possible to nest multiple data objects:
class ArtistData extends Data
{
public function __construct(
public string $name,
public int $age,
) {
}
}
class AlbumData extends Data
{
public function __construct(
public string $title,
public ArtistData $artist,
) {
}
}
new AlbumData(
'Never gonna give you up',
new ArtistData('Rick Astley', 22)
);
AlbumData::from([
'title' => 'Never gonna give you up',
'artist' => [
'name' => 'Rick Astley',
'age' => 22
]
]);
Collections of Data Objects
What if you want to nest a collection of data objects within a data object?
That’s perfectly possible, but there’s a small catch; you should always define what kind of data objects will be stored within the collection. This is really important later on to create validation rules for data objects or partially transforming data objects.
There are a few different ways to define what kind of data objects will be stored within a collection. You could use an annotation, for example, which has an advantage that your IDE will have better suggestions when working with the data object. And as an extra benefit, static analyzers like PHPStan will also be able to detect errors when your code is using the wrong types.
Using DocBlock Annotations
A collection of data objects defined by annotation looks like this:
/**
* @property \App\Data\SongData[] $songs
*/
class AlbumData extends Data
{
public function __construct(
public string $title,
public array $songs,
) {
}
}
class AlbumData extends Data
{
public string $title;
/** @var \App\Data\SongData[] */
public array $songs;
}
use App\Data\SongData;
class AlbumData extends Data
{
/** @var SongData[] */
public array $songs;
}
Using Generics
It is also possible to use generics:
use App\Data\SongData;
class AlbumData extends Data
{
/** @var array<SongData> */
public array $songs;
}
Laravel Collections
The same is true for Laravel collections, but be sure to use two generic parameters to describe the collection. One for the collection key type and one for the data object type:
use App\Data\SongData;
use Illuminate\Support\Collection;
class AlbumData extends Data
{
/** @var Collection<int, SongData> */
public Collection $songs;
}
Well-Annotated Collections
If the collection is well-annotated, the Data class doesn’t need to use annotations:
/**
* @template TKey of array-key
* @template TData of \App\Data\SongData
*
* @extends \Illuminate\Support\Collection<TKey, TData>
*/
class SongDataCollection extends Collection
{
}
class AlbumData extends Data
{
public function __construct(
public string $title,
public SongDataCollection $songs,
) {
}
}
Using Attributes
You can also use an attribute to define the type of data objects that will be stored within a collection:
class AlbumData extends Data
{
public function __construct(
public string $title,
#[DataCollectionOf(SongData::class)]
public array $songs,
) {
}
}
This was the old way to define the type of data objects that will be stored within a collection. It is still supported, but we recommend using the annotation since static analyzers and IDEs will have better support for that.