component-value-objects

Current Status

Features

It supports SimpleValueObjects and ComplexValueObjects.

Complex value objects are hydrated passing an array. If a key of the array isn't recognized as property of the object it is added to the $otherData array so it isn't lost.

Some of those value objects support also the persistence in Doctrine providing custom mapping types (See below).

What are Value Objects

Value Objects are PHP objects that represent and manage simple or complex values. Once set, the value object cannot be modified without changing its identity.

Simple value objects represent a simple value, like an email. Complex value objects represent complex values, that, in order to really represent a value, need more than one value, like a price that needs an amount and a currency to be understandable and have a sense.

PHP supports only one value object: the DateTime object.

This library gives support for other kind of values, differentiating them between complex and simple.

To better understand the concepts behind the value objects, you can read this post.

Install component-value-objects via Composer

$ composer require serendipity_hq/component-value-objects

This library follows the http://semver.org/ versioning conventions.

Instructions to install Intl PHP extension in MAMP for Mac

Available Value Objects

Currently, this library supports the following Value Objects:

• Address: Built-in. A more advanced value object is commerceguys/addressing (but it more suited for shipping addresses than for addresses themself);
• CurrencyExchangeRate: Built-in;
• Email: A basic class derived from Wowo's gist EmailValueObject. It implements `egulias/email-validator to validate emails;
• IP: Just a proxy for the library darsyn/ip;
• Money: Just a proxy for the library moneyphp/money;
• Payment: Built-in
• Phone: Just a proxy for the library giggsey/libphonenumber-for-php;
• Tax: Built-in
• Uri: Just a proxy for the library Laminas\Uri (formerly Zend Uri). A more advanced value object is League\Uri
• VatRate: Built-in
• VatNumber: Built-in

Supported features