https://github.com/dave-redfern/somnambulist-value-objects
Simple value object implementation for PHP
https://github.com/dave-redfern/somnambulist-value-objects
domain-driven-design value-object
Last synced: about 1 year ago
JSON representation
Simple value object implementation for PHP
- Host: GitHub
- URL: https://github.com/dave-redfern/somnambulist-value-objects
- Owner: dave-redfern
- License: mit
- Archived: true
- Created: 2017-06-23T19:34:11.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2019-07-05T22:46:43.000Z (almost 7 years ago)
- Last Synced: 2025-02-27T17:59:39.258Z (over 1 year ago)
- Topics: domain-driven-design, value-object
- Language: PHP
- Size: 46.9 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Moved to https://github.com/dave-redfern/somnambulist-domain
This repository has been archived. Please update to the combined package.s
## Value Objects Library
Value Objects (VOs) are Immutable domain objects that represent some value in your domain model but without
a thread of continuous identity i.e. their identity is through their properties. VOs allow your entities to
encapsulate properties and provide type safety.
This library provides an abstract base class that provides a basic equality test and foundation for your
VOs along with a couple of basic types. As VOs form part of YOUR domain, you should implement the VOs that
you need for your domain, following your domain naming (e.g. if you do not call an email address an
EmailAddress then create your own VO for that purpose).
VOs should be self-validating during construction. For this purpose, the Assertion library by Benjamin
Eberlei is used, however you may wish to use another or filter_var() etc directly.
If you see something missing or have suggestions for other methods, submit a PR or ticket.
### Requirements
* PHP 7+
* mb_string
* beberlei/assert
* eloquent/enumeration
* somnambulist/collection
### Installation
Install using composer, or checkout / pull the files from github.com.
* composer require somnambulist/value-objects
### Usage
Extend the abstract value object and implement the single required method toString(). The default equality
method (equals()) uses reflection on the VO properties and compares them directly - only between VO types.
For example:
```php
use Assert\Assert;
use Somnambulist\ValueObjects\AbstractValueObject;
class Uuid extends AbstractValueObject
{
/**
* @var string
*/
private $uuid;
/**
* Constructor.
*
* @param string $uuid
*/
public function __construct(string $uuid)
{
Assert::that($uuid, null, 'uuid')->notEmpty()->uuid();
$this->uuid = $uuid;
}
/**
* @return string
*/
public function toString(): string
{
return $this->uuid;
}
}
$uuid = new Uuid(\Ramsey\Uuid\Uuid::uuid4());
```
#### Usage with Doctrine
These VOs may be used with Doctrine as Embeddable objects - however if you allow the VO to be null, it will
be instantiated empty so your methods / toString() should handle that case e.g.:
A User has a nullable Profile VO, when Doctrine hydrates the User, the Profile VO will also be hydrated but
empty, so if the Profile has a nickname() or avatar() method, these must support returning null and your
toString() method must cast null to a string to avoid type errors.
### Links
* [Doctrine](http://doctrine-project.org)
* [Enumeration Bridge](https://github.com/dave-redfern/somnambulist-doctrine-enum-bridge)