serendipity_hq/php_value_objects

A set of value objects to manage simple and composite values

, _(*1)

Serendipity HQ Value Objects

A set of PHP Value Objects to manage simple and composite values., _(*2)

, _(*3)

Supports: , _(*4)

Tested with: , _(*5)

, _(*6)

Current Status

, _(*7)

, _(*8)

Features

It supports SimpleValueObjects and ComplexValueObjects., _(*9)

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., _(*10)

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

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! , _(*12)

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., _(*13)

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., _(*14)

PHP supports only one value object: the DateTime object., _(*15)

This library gives support for other kind of values, differentiating them between complex and simple., _(*16)

To better understand the concepts behind the value objects, you can read this post., _(*17)

Install component-value-objects via Composer

$ composer require serendipity_hq/component-value-objects

This library follows the http://semver.org/ versioning conventions., _(*18)

Instructions to install Intl PHP extension in MAMP for Mac, _(*19)

Available Value Objects

Currently, this library supports the following Value Objects:, _(*20)

• 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

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! , _(*21)