Download the PHP package ibrostudio/laravel-data-repository without Composer

Laravel Data Objects Repository

Save Data Transfer Objects (from Spatie's Laravel Data) and Value Objects (from Michael Rubel's Laravel Value Objects) in database and attach to eloquent models.

Installation

Install the package via composer:

Then run the installer:

Usage

Add the trait IBroStudio\DataRepository\Concerns\HasDataRepository to your Eloquent models.

The trait implements a MorphManyDataObjects relationship that extends MorphMany.

Working with DTO

Create your DTO following Spatie's Laravel Data documentation.

Working with Value Objects

Use built-in Value Objects or create one following Michael Rubel's Value Objects documentation.

Save the Value Object attached to the model in database:

For more complex usage, you can use Value Objects in DTO:

Creating or updating objects

The following method save the object in database and attach it to the model:

If an object with the sans data class is already attached to the model, its values will be replaced.

Unique data class

You can attach many objects to a model but only one for each data class by default. Considering the previous examples, the model can have only one SongData object (and other DTO or Value Objects).

Multiple data class

If you need more than one object from the same data class, use the valuesAttributes parameter when you create or update an object:

Retrieving objects

You access to all MorphManyDataObjects relations for a model with:

You can limit the instance to a specific data class to access a single object:

The object is then retrieved by the values() method:

If necessary, you can also constrain the retrieval of the object to certain values of this object with the valuesQuery parameter:

Eloquent attribute casting

You can get direct access to an object value like $model->song instead of $model->data_repository(dataClass: SongData::class).

Add a unsignedBigInteger column to your model:

And then add the cast to the model class:

Usage:

You can constrain the property to a defined data class by adding it to the cast:

This adds data validation and automatic instantiation of the data class, allowing you to simply pass an array to the property setter:

Built-in Objects Values

• ByteUnit
• EncryptableText
• GitSshUrl
• HashedPassword
• IpAddress
• SemanticVersion
• Timecode
• VersionedComposerJson
• Name, FirstName, LastName, Fullname, CompanyName
• Email
• Phone
• TaxNumber

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.