PHPackages                             david-garcia/value-object - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. david-garcia/value-object

ActiveLibrary

david-garcia/value-object
=========================

Just another library to handle Value Objects and prevent the bad habit of Primitive Obsession

0.2.0(5y ago)08MITPHPPHP >= 7.4

Since Feb 9Pushed 5y ago1 watchersCompare

[ Source](https://github.com/DavidGarciaCat/php-value-object)[ Packagist](https://packagist.org/packages/david-garcia/value-object)[ RSS](/packages/david-garcia-value-object/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (2)Dependencies (5)Versions (3)Used By (0)

PHP Value Object
================

[](#php-value-object)

Just another library to handle Value Objects and prevent the bad habit of Primitive Obsession

[![Latest Version](https://camo.githubusercontent.com/4a52ffaedd8f24af2870596b6a97fd5501439ef218705ba9c2ee88631b9b61d6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f44617669644761726369614361742f7068702d76616c75652d6f626a6563742e7376673f7374796c653d666c61742d737175617265)](https://github.com/DavidGarciaCat/php-value-object/releases)[![Build Status](https://camo.githubusercontent.com/37bf89e469991b2648e0f289426988e8180ac94305b52cda27017f38b9530468/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f6275696c642f672f44617669644761726369614361742f7068702d76616c75652d6f626a6563742e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/DavidGarciaCat/php-value-object)[![Code Coverage](https://camo.githubusercontent.com/f07a50fa1144268f2cc2e8f50965cd89cb9454a7e875a6a93410017d30c3787b/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f44617669644761726369614361742f7068702d76616c75652d6f626a6563742e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/DavidGarciaCat/php-value-object)[![Quality Score](https://camo.githubusercontent.com/dd32e4994e0929d3daf31c826b69e8c57b76230435c1efbc3d9b11aad67e4af1/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f44617669644761726369614361742f7068702d76616c75652d6f626a6563742e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/DavidGarciaCat/php-value-object)[![Total Downloads](https://camo.githubusercontent.com/0c3910a67661d98d8ec3ca8ed92e17f810eaa07a1292984ebc55a9ea67130713/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f44617669644761726369614361742f7068702d76616c75652d6f626a6563742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/DavidGarciaCat/php-value-object)

Changelog
---------

[](#changelog)

All notable changes to this project will be documented in [this ChangeLog file](CHANGELOG.md).

Install
-------

[](#install)

Require the vendor with Composer:

```
composer require david-garcia/value-object
```

Usage
-----

[](#usage)

Make sure you are loading the Composer autoload:

```
require 'vendor/autoload.php';
```

Don't forget adding the use statement for each one of the value objects you need to use:

```
// Example for StringValue
use DavidGarcia\ValueObject\Primitive\StringValue;
```

All value objects have a static `create()` method:

```
StringValue::create('qwerty');
```

The first argument is the value to be wrapped by the value object. The second argument allows you to `statically cache` the value object, so you can instantiate twice an object with the same value but the system will create it just once:

```
$stringValue1 = StringValue::create('qwerty', true);
$stringValue2 = StringValue::create('qwerty', true);

if ($stringValue1 === $stringValue2) {
    // TRUE
    // It's the same object, so it goes inside this conditional
}

$stringValue3 = StringValue::create('qwerty');
$stringValue4 = StringValue::create('qwerty');

if ($stringValue3 === $stringValue4) {
    // FALSE
    // Although they have the same value, the system has created two different objects
}
```

Null values always hold a `null` value:

```
// `NullValue` does not expect any argument
$nullValue = NullValue::create();
```

All value objects have a `getValue()` method to expose the value:

```
$stringValue = StringValue::create('qwerty');
$stringValue->getValue(); // Returns 'qwerty'
```

The `StringValue` value object and any other that extends from this one can use the `__toString` magic method to return the string value, as an alternative to the `getValue()` method:

```
$stringValue = StringValue::create('qwerty');
(string) $stringValue; // Returns 'qwerty'
```

All value objects (except `NullValue`) have an `equals()` method that compares the content of two value objects of the same type:

```
$stringValue1 = StringValue::create('qwerty', true);
$stringValue2 = StringValue::create('qwerty', true);

if ($stringValue1->equals($stringValue2)) {
    // TRUE
    // We ignore the fact that is a cached object, as we compare the value
}

$stringValue3 = StringValue::create('qwerty');
$stringValue4 = StringValue::create('qwerty');

if ($stringValue3->equals($stringValue4)) {
    // TRUE
    // We have a match for the values, so even if we handle two different objects,
    // their values are equal
}
```

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

2

Last Release

1913d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/62c1db3c19dedf826fe3b41a2fa2df2cc65ec69bd0f388b9854c624e85af5fa4?d=identicon)[DavidGarciaCat](/maintainers/DavidGarciaCat)

---

Top Contributors

[![DavidGarciaCat](https://avatars.githubusercontent.com/u/7809429?v=4)](https://github.com/DavidGarciaCat "DavidGarciaCat (33 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/david-garcia-value-object/health.svg)

```
[![Health](https://phpackages.com/badges/david-garcia-value-object/health.svg)](https://phpackages.com/packages/david-garcia-value-object)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M16.9k](/packages/laravel-framework)[phpdocumentor/reflection-docblock

With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock.

9.4k722.2M1.2k](/packages/phpdocumentor-reflection-docblock)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M647](/packages/sylius-sylius)[symfony/mailer

Helps sending emails

1.6k368.1M948](/packages/symfony-mailer)[infection/infection

Infection is a Mutation Testing framework for PHP. The mutation adequacy score can be used to measure the effectiveness of a test set in terms of its ability to detect faults.

2.2k26.2M1.8k](/packages/infection-infection)[mailgun/mailgun-php

The Mailgun SDK provides methods for all API functions.

1.1k28.9M163](/packages/mailgun-mailgun-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)