Serendipity HQ Value Objects

A set of PHP Value Objects to manage simple and composite values.

Supports:

Tested with:

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).

---

Do you like this library?
LEAVE A ★

or run
composer global require symfony/thanks && composer thanks
to say thank you to all libraries you use in your current project, this included!

---

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

ValueObject	Doctrine		Symfony
	Embeddable	Type	Form Type	Twig filter
Address	✓	✕	✓	✕
Currency	N/A	✓	✕	✕
CurrencyExchangeRate	N/A	N/A	N/A	N/A
Email	N/A	✓	N/A	N/A
IP	N/A	N/A	N/A	N/A
Money	N/A	✓	✓	✓
Payment	✕	✕	✕	✕
Phone	✕	✕	✕	✕
Tax	✕	✕	✕	✕
Uri	✕	✓	✕	✕
VAT Rate	✕	✕	✕	✕
VAT Number	✕	✕	✕	✕

---

Do you like this library?
LEAVE A ★

or run
composer global require symfony/thanks && composer thanks
to say thank you to all libraries you use in your current project, this included!

---