githubjeka / value-object
Help to create immutable Value Objects
v1.0.0
2016-01-25 11:21 UTC
Requires
- php: >=5.4.0
This package is auto-updated.
Last update: 2024-10-19 17:24:50 UTC
README
Help to create immutable Value Objects
Default API
Two methods compareTo
and changeTo
:
// Value Object is a Metre(['1', 'centimeter']) $metre = new Metre(['1', 'cm']); $metre->compareTo([2,'cm']); // returns -1 $metre->compareTo([.1,'m']); // returns 0 $metre->compareTo([1,'mm']); // returns 1 $metre->changeTo([1,'m']) //returns new Metre(['1', 'm']), $metre is Metre(['1', 'centimeter']) //user API via changeTo $metre->toMillimeter(); // new Metre(['10', 'mm']), $metre is Metre(['1', 'centimeter']) $metre->toMillimeter()->add([1,'mm'])->getAmount(); //returns 11 // rewrite __toString() echo $metre // returns '1'
a little more
final class Money { use ImmutableValueObject; private $amount; private $currency; protected function compare($valueObject) { return bccomp($this->toUsd()->amount, $valueObject->toUsd()->amount); } protected function setAttributes($value) { // ... validate value $this->currency = $value[1]; $this->amount = $value[0]; } private function getCurrencies() { return [ 'usd' => 1, 'rub' => 60, //... ]; } public function toUsd() { if ($this->currency === 'usd') { return $this->changeTo([$this->amount, 'usd']); } $k = $this->getCurrencies()[$this->currency]; return $this->changeTo([$this->amount * $k, 'usd']); } public function toRub() { $amount = $this->toUsd()->amount; $k = $this->getCurrencies()['rub']; return $this->changeTo([$amount / $k, 'rub']); } }