Download the PHP package morrislaptop/laravel-popo-caster without Composer

Automatically cast JSON columns to rich PHP objects in Laravel using Symfony's Serializer

Laravel is awesome. Spatie's data transfer object package for PHP is awesome. But they don't cast objects like dates to DateTimes and collections are a bit of pain. Plain Old PHP Objects (POPOs) are a bit better in that regard.

Have you ever wanted to cast your JSON columns to a value object?

This package gives you 2 caster classes:

• Serializer which serializes your value object and stores it in a single JSON field
• Normalizer which normalizes your value object and stores the properties as fields on your model

Under the hood it implements Laravel's Castable interface with a Laravel custom cast that handles serializing between the object (or a compatible array) and your JSON database column. It uses Symfony's Serializer to do this.

This package is inspired by Laravel Castable Data Transfer Object!

Installation

You can install the package via composer:

Serializer Usage

1. Create your POPO

2. Configure your Eloquent attribute to cast to it:

Note that this should be a jsonb or json column in your database schema. Objects and arrays are both supported.

And that's it! You can now pass either an instance of your Address class, or even just an array with a compatible structure. It will automatically be cast between your class and JSON for storage and the data will be validated on the way in and out.

But the best part is that you can decorate your class with domain-specific methods to turn it into a powerful value object.

Normalizer Usage

1. Create your POPO

2. Configure your Eloquent attribute to cast to it:

Note that the properties of your value object should be columns in your database schema.

And that's it! You can now pass either an instance of your Money class, or set the individual properties on the model. It will automatically be cast between your class and properties for storage and the data will be validated on the way in and out.

But the best part is that you can decorate your class with domain-specific methods to turn it into a powerful value object.

Plug

Want an easy way to mock or have factories for your POPOs? Check out morrislaptop/popo-factory

Testing

Changelog

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

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Craig Morris
• All Contributors

License

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