PHPackages                             orkin/valueobjects - 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 &amp; Helpers](/categories/utility)
4. /
5. orkin/valueobjects

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

orkin/valueobjects
==================

A PHP library/collection of classes aimed to help developers using and understanding immutable objects.

v6.0(5y ago)15.0kMITPHPPHP &gt;=7.4

Since Dec 14Pushed 5y ago1 watchersCompare

[ Source](https://github.com/Orkin/valueobjects)[ Packagist](https://packagist.org/packages/orkin/valueobjects)[ RSS](/packages/orkin-valueobjects/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (2)Dependencies (6)Versions (15)Used By (0)

IMPORTANT!
==========

[](#important)

This is a fork of the `nicolopignatelli/valueobjects` library which was removed from GitHub. It's kept around for backwards compatibility in projects that were already using it. However, we do not maintain this project and do not advise you to use it in production.

---

ValueObjects
============

[](#valueobjects)

[![Build Status](https://camo.githubusercontent.com/c41e5f78ebb4987bf1e70282e9310197d1523b75054d3767e212921076ecbbfc/68747470733a2f2f7472617669732d63692e6f72672f6e69636f6c6f7069676e6174656c6c692f76616c75656f626a656374732e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/nicolopignatelli/valueobjects)[![Scrutinizer Quality Score](https://camo.githubusercontent.com/9220ad369615d35b49774654281d96bcf39ae99a227d21128dbfba66ee7fb955/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6e69636f6c6f7069676e6174656c6c692f76616c75656f626a656374732f6261646765732f7175616c6974792d73636f72652e706e673f733d39373935363763326437393166666265616231323737376336306338656462383637373664646363)](https://scrutinizer-ci.com/g/nicolopignatelli/valueobjects/)[![Code Coverage](https://camo.githubusercontent.com/a33da6def007db4505abec4bf1fd63b6ce60a69531cc3c895dd84d7b98a08e34/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6e69636f6c6f7069676e6174656c6c692f76616c75656f626a656374732f6261646765732f636f7665726167652e706e673f733d35396464346131343234313261396463643938393837303631306631633966383963313963663438)](https://scrutinizer-ci.com/g/nicolopignatelli/valueobjects/)[![SensioLabsInsight](https://camo.githubusercontent.com/7fea095f150ae2ac264e2cd9690dd95d619ae8ca758d642b432477f466ccde7a/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f32343661326461362d666664622d343733302d393231362d3634376662376161633338332f6d696e692e706e67)](https://insight.sensiolabs.com/projects/246a2da6-ffdb-4730-9216-647fb7aac383)

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

Should I use this library?
--------------------------

[](#should-i-use-this-library)

Not in production enviroments. Although fully tested, ValueObjects has been developed mainly for educational purposes. Therefore, it can be used in personal projects and to force yourself on thinking in terms of immutable objects and their interaction.

When approaching a project using Domain Driven Design, I would suggest to write your own Value Objects in a way they will reflect 100% your domain, without using any library or class designed to solve a general problem more than your specific one.

In short, learn from it then throw it away.

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

[](#documentation)

- [Introduction](http://nicolopignatelli.github.io/valueobjects/index.html)
- [Installation](http://nicolopignatelli.github.io/valueobjects/installation.html)
- [API reference](http://nicolopignatelli.github.io/valueobjects/api/2.x/)
- [About](http://nicolopignatelli.github.io/valueobjects/about.html)

Contributing
------------

[](#contributing)

See [CONTRIBUTING](/CONTRIBUTING.md) file.

License
-------

[](#license)

ValueObjects is released under the MIT License. See the bundled [LICENSE](/LICENSE) file for details.

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 76.4% 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 ~193 days

Recently: every ~498 days

Total

14

Last Release

2023d ago

Major Versions

1.x-dev → v2.12014-09-24

v2.3 → v3.02015-05-15

v3.0 → v4.02016-01-10

v4.1 → v5.02018-04-29

v5.0 → v6.02020-10-30

PHP version history (4 changes)v1.0PHP &gt;=5.3.3

v4.0PHP &gt;=5.4

v5.0PHP &gt;=5.5

v6.0PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/0498127a4ce50146f2beb88fb49a9a0865856a31322f45e8635169a4ee93fea7?d=identicon)[Orkin](/maintainers/Orkin)

---

Top Contributors

[![nicolopignatelli](https://avatars.githubusercontent.com/u/1071681?v=4)](https://github.com/nicolopignatelli "nicolopignatelli (107 commits)")[![dbellettini](https://avatars.githubusercontent.com/u/325358?v=4)](https://github.com/dbellettini "dbellettini (5 commits)")[![Orkin](https://avatars.githubusercontent.com/u/1061903?v=4)](https://github.com/Orkin "Orkin (5 commits)")[![mbadolato](https://avatars.githubusercontent.com/u/164615?v=4)](https://github.com/mbadolato "mbadolato (5 commits)")[![localheinz](https://avatars.githubusercontent.com/u/605483?v=4)](https://github.com/localheinz "localheinz (4 commits)")[![ajgarlag](https://avatars.githubusercontent.com/u/388184?v=4)](https://github.com/ajgarlag "ajgarlag (3 commits)")[![marcosh](https://avatars.githubusercontent.com/u/2643972?v=4)](https://github.com/marcosh "marcosh (2 commits)")[![andrzejkupczyk](https://avatars.githubusercontent.com/u/11018286?v=4)](https://github.com/andrzejkupczyk "andrzejkupczyk (2 commits)")[![braddle](https://avatars.githubusercontent.com/u/1675150?v=4)](https://github.com/braddle "braddle (1 commits)")[![gabrielsch](https://avatars.githubusercontent.com/u/1733354?v=4)](https://github.com/gabrielsch "gabrielsch (1 commits)")[![bitdeli-chef](https://avatars.githubusercontent.com/u/3092978?v=4)](https://github.com/bitdeli-chef "bitdeli-chef (1 commits)")[![neeckeloo](https://avatars.githubusercontent.com/u/1768645?v=4)](https://github.com/neeckeloo "neeckeloo (1 commits)")[![bertramakers](https://avatars.githubusercontent.com/u/959026?v=4)](https://github.com/bertramakers "bertramakers (1 commits)")[![mathroc](https://avatars.githubusercontent.com/u/291531?v=4)](https://github.com/mathroc "mathroc (1 commits)")[![liuggio](https://avatars.githubusercontent.com/u/530406?v=4)](https://github.com/liuggio "liuggio (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/orkin-valueobjects/health.svg)

```
[![Health](https://phpackages.com/badges/orkin-valueobjects/health.svg)](https://phpackages.com/packages/orkin-valueobjects)
```

###  Alternatives

[cknow/laravel-money

Laravel Money

1.0k4.3M22](/packages/cknow-laravel-money)[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)
