Skip to content

Aerendir/component-value-objects

Repository files navigation

Serendipity HQ Value Objects

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

Supports:

Tested with:

Current Status

Coverage Maintainability Rating Quality Gate Status Reliability Rating Security Rating Technical Debt Vulnerabilities

Phan PHPStan PSalm PHPUnit Composer PHP CS Fixer Rector

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:

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!


About

A set of PHP Value Objects to manage composite values

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published