PHPackages                             xdevmafia/php-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. [Utility & Helpers](/categories/utility)
4. /
5. xdevmafia/php-value-object

ActiveLibrary[Utility & Helpers](/categories/utility)

xdevmafia/php-value-object
==========================

Value objects for PHP

v1.0.2(3y ago)170MITPHPPHP >=7.4

Since Jun 17Pushed 3y agoCompare

[ Source](https://github.com/xdevmafia/php-value-object)[ Packagist](https://packagist.org/packages/xdevmafia/php-value-object)[ RSS](/packages/xdevmafia-php-value-object/feed)WikiDiscussions master Synced 1mo ago

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

Value objects for PHP
=====================

[](#value-objects-for-php)

Easy way for validate, normalize and format values.

Installation
------------

[](#installation)

Install the latest version with:

```
$ composer require xdevmafia/php-value-object
```

Basic Usage
-----------

[](#basic-usage)

```
use XDM\ValueObject\Object\EmailObject;
use XDM\ValueObject\Type\StringType;

class User
{
    private StringType $username;
    private EmailObject $email;

    public function __construct(StringType $username, EmailObject $email)
    {
        $this->username = $username;
        $this->email = $email;
    }

    public function getUsername(): StringType
    {
        return $this->username;
    }

    public function setUsername(StringType $username): void
    {
        $this->username = $username;
    }

    public function getEmail(): EmailObject
    {
        return $this->email;
    }

    public function setEmail(EmailObject $email): void
    {
        $this->email = $email;
    }
}
```

```
try {
    $username = new StringType('xdevmafia');
    $email = new EmailObject('info@xdevmafia.org');
} catch (ConstraintException $e) {
    throw $e;
}

$user = new User($username, $email);
```

Types
-----

[](#types)

List of available **Type** classes:

- IntType
- FloatType
- StringType
- BoolType
- ArrayType
- ObjectType
- MixedType

Constraints
-----------

[](#constraints)

List of available **Constraint** classes:

- DateFormat
- Domain
- Email
- Enum
- Ip
- IsObject
- Json
- Max
- MaxLength
- Min
- MinLength
- NotEmpty
- NotNull
- Regex
- Url
- Uuid

Objects
-------

[](#objects)

List of available **Object** classes:

- DateObject
- DateTimeObject
- DomainObject
- EmailObject
- IpObject
- JsonObject
- UrlObject
- UuidObject

Object extends \***Type** class:

```
use XDM\ValueObject\Constraint\Email;
use XDM\ValueObject\Type\StringType;

class EmailObject extends StringType
{
    protected function setConstraints(): void
    {
        $this->addConstraint(new Email());
    }
}
```

You can create own objects:

```
namespace App\ValueObject;

use XDM\ValueObject\Type\StringType;

class DeliveryAddressObject extends StringType
{
}
```

With constraints:

```
use XDM\ValueObject\Constraint\Regex;
use XDM\ValueObject\Type\StringType;

class UsernameObject extends StringType
{
    protected function setConstraints(): void
    {
        $this->addConstraint(new Regex('[a-z]{3,10}'));
    }
}
```

You can create own constraints.

Invokable class will be return `bool` value:

```
namespace App\Constraint;

use XDM\ValueObject\Constraint;

class HexColor implements Constraint
{
    public function __invoke($value): bool
    {
        return ctype_xdigit($value);
    }
}
```

And object that uses this constraint:

```
namespace App\ValueObject;

use App\Constraint\HexColor;
use XDM\ValueObject\Type\StringType;

class ColorObject extends StringType
{
    protected function setConstraints(): void
    {
        $this->addConstraint(new HexColor());
    }
}
```

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

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 ~148 days

Total

3

Last Release

1136d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/feb69400f639517e68ba7ee3c3eb3451faca0ec1ae51de2ec0d6d78b92aa82a0?d=identicon)[atotskii](/maintainers/atotskii)

---

Top Contributors

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

---

Tags

Value Objectddd

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/xdevmafia-php-value-object/health.svg)

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

###  Alternatives

[moneyphp/money

PHP implementation of Fowler's Money pattern

4.8k82.5M422](/packages/moneyphp-money)[prooph/service-bus

PHP Enterprise Service Bus Implementation supporting CQRS and DDD

4421.4M32](/packages/prooph-service-bus)[ecotone/ecotone

Supporting you in building DDD, CQRS, Event Sourcing applications with ease.

558549.8k17](/packages/ecotone-ecotone)[prooph/event-sourcing

PHP EventSourcing library

267808.5k18](/packages/prooph-event-sourcing)[phpmentors/domain-kata

Kata for domain models

73426.9k9](/packages/phpmentors-domain-kata)[aura/payload

A Domain Payload implementation.

56370.4k9](/packages/aura-payload)

PHPackages © 2026

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