laravel-value-objects

What problem does it solve?

Laravel applications often need robust representations of core domain concepts. This Skill provides a pattern to model domain values as immutable objects that encapsulate rules, ensure safe equality, and prevent unintended mutations across the system.

Core Features & Use Cases

• Immutability with readonly properties to guarantee safe value semantics.
• Static factory methods for expressive, intention-revealing construction.
• Encapsulated domain logic: validation and behavior within the value object.
• Common domain value examples: money, process result, coordinates, and email addresses.
• Use Case: Represent monetary amounts with currency, perform calculations without mutating originals.

Quick Start

In a Laravel project, define a Money value object following the Money.php pattern under app/Values, then use Money::fromDollars(29.99) to create amounts and perform adds or multiplications as needed.