PHPackages                             renandelmonico/value-objects - 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. renandelmonico/value-objects

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

renandelmonico/value-objects
============================

A library with VOs to agreggate in your projects

v0.2.0(3y ago)542[1 PRs](https://github.com/renandelmonico/value-objects/pulls)MITPHPPHP >=8.2

Since Apr 18Pushed 1y ago1 watchersCompare

[ Source](https://github.com/renandelmonico/value-objects)[ Packagist](https://packagist.org/packages/renandelmonico/value-objects)[ Docs](https://github.com/renandelmonico/value-objects)[ RSS](/packages/renandelmonico-value-objects/feed)WikiDiscussions main Synced 1mo ago

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

Value Objects Library
=====================

[](#value-objects-library)

[![Packagist Downloads](https://camo.githubusercontent.com/1b8cb4456a41516b85cf345ed6f3364ba195c26dd8f777d144fec22fc85dd5ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)](https://camo.githubusercontent.com/1b8cb4456a41516b85cf345ed6f3364ba195c26dd8f777d144fec22fc85dd5ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)[![Packagist Stars](https://camo.githubusercontent.com/d6d9b00daa2103086a7cf424fdad884ab5b1cd738150b59e1b298e44fa9038a1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)](https://camo.githubusercontent.com/d6d9b00daa2103086a7cf424fdad884ab5b1cd738150b59e1b298e44fa9038a1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)[![GitHub release (latest by date)](https://camo.githubusercontent.com/0c12904a427c75e4f08b265520abfe854efebc35c52ee54c4eff4740bd2323a2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)](https://camo.githubusercontent.com/0c12904a427c75e4f08b265520abfe854efebc35c52ee54c4eff4740bd2323a2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)[![Packagist PHP Version Support](https://camo.githubusercontent.com/2c654412e9bb48c71f3643361092aa48b482b1de76b1ad031ff83e3e13202361/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)](https://camo.githubusercontent.com/2c654412e9bb48c71f3643361092aa48b482b1de76b1ad031ff83e3e13202361/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)[![Packagist License](https://camo.githubusercontent.com/3f109aefdf112dd1e44b006b9123f0fbdf655cecbbed2b96e291984fac8c278d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)](https://camo.githubusercontent.com/3f109aefdf112dd1e44b006b9123f0fbdf655cecbbed2b96e291984fac8c278d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f72656e616e64656c6d6f6e69636f2f76616c75652d6f626a65637473)

A lib to aggregate in your projects with most commons VO's.

> Produced by Renan Delmonico to use in his projects

Summary
=======

[](#summary)

- [What's Value Objects](#whats-value-objects)
- [Documentation](#documentation)
- [Value Objects](#value-objects)
- [Enums](#enums)
- [Pull Requests](#pull-requests)

What's Value Objects?
---------------------

[](#whats-value-objects)

- [Martin Fowler's Blog: ValueObject](https://martinfowler.com/bliki/ValueObject.html)

Documentation
-------------

[](#documentation)

To read the documentation run the Makefile command:

```
make doc-generate
```

Value Objects
-------------

[](#value-objects)

- Address
- Boolean
- City
- DateTime
- Email
- Integer
- IP (IPv4 and IPv6)
- Numeric
- Password
- Str
- Text
- UUID

Enums
-----

[](#enums)

- Country
- PasswordAlgo
- State (Brazil)

Pull Requests
-------------

[](#pull-requests)

Before you submit a Pull Request you must run the unit and mutation tests and check if the coverage is 100%.

### How?

[](#how)

There are three commands in Makefile (`test-unit`, `test-mutation` and `test-coverage`). You must run this commands.

> Please, rate this lib ❤️ and give stars ⭐

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity54

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

Total

3

Last Release

1172d ago

PHP version history (2 changes)v0.1.1PHP >=8.1

v0.2.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/2dfc9c1a49c6198d75e1a754c4466014544f5ce72bb12e59250218dfa37ca067?d=identicon)[renandelmonico](/maintainers/renandelmonico)

---

Top Contributors

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

---

Tags

phptypesvalue-objectvalue-objectsvoobjectobjectsvalue

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/renandelmonico-value-objects/health.svg)

```
[![Health](https://phpackages.com/badges/renandelmonico-value-objects/health.svg)](https://phpackages.com/packages/renandelmonico-value-objects)
```

###  Alternatives

[myclabs/deep-copy

Create deep copies (clones) of your objects

8.9k849.8M169](/packages/myclabs-deep-copy)[symfony/property-access

Provides functions to read and write from/to an object or array using a simple string notation

2.8k295.3M2.5k](/packages/symfony-property-access)[moneyphp/money

PHP implementation of Fowler's Money pattern

4.8k82.5M422](/packages/moneyphp-money)[cuyz/valinor

Dependency free PHP library that helps to map any input into a strongly-typed structure.

1.5k9.2M108](/packages/cuyz-valinor)[ytake/valueobjects

A PHP library/collection of classes aimed to help developers using and undestanding immutable objects.(temporary package)

6086.2k](/packages/ytake-valueobjects)

PHPackages © 2026

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