jakubgiminski/value-object

Library of abstract classes intended to be used as bases for value objects.

Value Object

This library is useful for building value objects in php. It is a collection of abstract classes (each for every scalar type), that contain common validation mechanisms, so you don't have to write them., _(*1)

So far, we have StringValue and IntegerValue which already satisfy most of the needs. More scalar representations may be implemented in the future (feel free to contribute)., _(*2)

Look here to find some unit tested examples., _(*3)

Required PHP version: 7.0.0 or higher, _(*4)

Installation

composer require jakubgiminski/value-object

Overview

Every ValueObject has a getValue() method., _(*5)

ValueObject\StringValue

Validation rules (optional):, _(*6)

/** @var int */
protected $minLength;

/** @var int */
protected $maxLength;

/** @var array */
protected $validValues = [];

Comparison methods:, _(*7)

public function isEqual(StringValueInterface $stringValue): bool;
public function isShorterThan(StringValueInterface $stringValue): bool;
public function isLongerThan(StringValueInterface $stringValue): bool;

Examples of usage: - Season - Password, _(*8)

ValueObject\IntegerValue

Validation rules (optional):, _(*9)

/** @var array */
protected $validRange = [];

/** @var array */
protected $validValues = [];

/** @var array */
protected $invalidValues = [];

Comparison methods:, _(*10)

public function isEqual(IntegerValueInterface $integerValue): bool;
public function isLessThan(IntegerValueInterface $integerValue): bool;
public function isGreaterThan(IntegerValueInterface $integerValue): bool;

Examples of usage: - Age - TheatreSeat, _(*11)