laravel-value-objects

To model domain concepts as immutable value objects in Laravel, use readonly properties and static factory methods to encapsulate rules and ensure safe equality. This prevents unintended mutations across services for values like money or addresses.

Representing money and currency safely in Laravel involves using a dedicated Money value object. This pattern encapsulates monetary amounts with currency, allowing you to perform calculations without mutating the original values.

You encapsulate domain validation rules inside Laravel models by shifting logic into static factory methods on value objects. This ensures explicit validation and predictable behavior during construction rather than relying on external validation.

Laravel supports readonly properties for domain modeling through PHP's native features. Using readonly properties enforces immutability, guaranteeing safe value semantics and preventing unintended mutations across your application's services.

To perform calculations on monetary values without mutating the original data, use an immutable Money value object. Static factory methods create new instances for operations like additions or multiplications, ensuring the original amount remains unchanged.

Domain logic behaves unpredictably across services in Laravel when shared mutable objects are modified unintentionally. Applying immutable value objects with readonly properties prevents these side effects and ensures safe equality throughout the system.