PHPackages                             phpgt/dataobject - 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. phpgt/dataobject

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

phpgt/dataobject
================

 Structured, type-safe, immutable data transfer.

v1.1.1(2mo ago)013.5k↑150.6%[1 issues](https://github.com/PhpGt/DataObject/issues)[3 PRs](https://github.com/PhpGt/DataObject/pulls)1MITPHPPHP >=8.1CI passing

Since Jan 17Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/PhpGt/DataObject)[ Packagist](https://packagist.org/packages/phpgt/dataobject)[ GitHub Sponsors](https://github.com/sponsors/phpgt)[ RSS](/packages/phpgt-dataobject/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (10)Versions (19)Used By (1)

Structured, type-safe, immutable data transfer.
===============================================

[](#structured-type-safe-immutable-data-transfer)

A Data Transfer Objects (DTO) in a programming language is a design pattern that facilitates transfer of data between different layers of an application. This library introduces the `DataObject` class which can be built from an existing associative array or standard object, using the `DataObjectBuilder` class.

---

[ ![Build status](https://camo.githubusercontent.com/91307b3bc70b7e9a451423611387d644e5f5edf1d9185ec2f0ada22da7cc84cc/68747470733a2f2f62616467652e7374617475732e7068702e67742f646174616f626a6563742d6275696c642e737667)](https://github.com/PhpGt/DataObject/actions)[ ![Code quality](https://camo.githubusercontent.com/a35b24b8cb39aad92d1d3cd053892f7399251b7a90fedeb493683c92b8fd31b8/68747470733a2f2f62616467652e7374617475732e7068702e67742f646174616f626a6563742d7175616c6974792e737667)](https://app.codacy.com/gh/PhpGt/DataObject)[ ![Code coverage](https://camo.githubusercontent.com/88e0ef72939d02c8bb9056622d4839a02ceb4851ddacb59d381e36c0ee8d20db/68747470733a2f2f62616467652e7374617475732e7068702e67742f646174616f626a6563742d636f7665726167652e737667)](https://app.codecov.io/gh/PhpGt/DataObject)[ ![Current version](https://camo.githubusercontent.com/bc2bc68c43398c4d83b2f71fda8dbf25fc571d5dbacde91bd310a35b6f29fd14/68747470733a2f2f62616467652e7374617475732e7068702e67742f646174616f626a6563742d76657273696f6e2e737667)](https://packagist.org/packages/PhpGt/DataObject)[ ![PHP.GT/DataObject documentation](https://camo.githubusercontent.com/69713fec2f82ee0852a53e1036d1ff32554ff16b75eccb07cbd0a17d1d2451cc/68747470733a2f2f62616467652e7374617475732e7068702e67742f646174616f626a6563742d646f63732e737667)](http://www.php.gt/dataobject)A `DataObject` has the following features:

- It is **immutable**, meaning that code can't modify the data it represents
- It provides **type-safe** getters to the contained data
- It can be **nested** within other `DataObject`s
- It can be converted to and from associative arrays and standard objects

Usage example
-------------

[](#usage-example)

Load an object into a `DataObject`, then pass to a third party library for processing.

Due to the immutability of the `DataObject` class, there is no risk of the third party library making changes to the contents of the data.

```
use GT\DataObject\DataObjectBuilder;

// Create a new Builder and build the DataObject from an associative array.
// For example, data loaded from another remote data source.
$sourceData = [
	"id" => 105,
	"name" => "Edgar Scolmore",
	"address" => [
		"street" => "32 Trestles Lane",
		"town" => "Lensworth",
		"county" => "Scamperingshire",
		"postcode" => "SC41 8PN"
	],
];
$builder = new DataObjectBuilder();
$data = $builder->fromAssociativeArray($sourceData);

// Pass the data to a third party to process it.
ThirdParty::processData($data);

// Now we can use the data ourselves for whatever purpose:
Database::store(
	id: $data->getInt("id"),
	refname: $data->getString("name"),
);
```

Working with JSON data
----------------------

[](#working-with-json-data)

A JSON data structure is almost identical in scope to the DataObject introduced in this repository, with one key difference: JSON data can represent a primitive data type, not always key-value-pairs. Because of this, [PHP.GT/Json is maintained separately to provide structured, type-safe, immutable JSON objects](https://php.gt/json) as an extension to this PHP.GT/DataObject repository.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance86

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity71

Established project with proven stability

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

Recently: every ~272 days

Total

14

Last Release

74d ago

Major Versions

v0.4.0 → v1.0.02021-03-15

PHP version history (2 changes)v0.1.0PHP >=8.0

v1.1.0PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/9e42344b91ce4b91ab57875969f67a0a6a48de570a08bc65d673b06b72fd3a3f?d=identicon)[g105b](/maintainers/g105b)

---

Top Contributors

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

---

Tags

data-transfer-objectdtodto-patternimmutableimmutable-datastructuresno-aitype-safety

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/phpgt-dataobject/health.svg)

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

###  Alternatives

[kornrunner/secp256k1

Pure PHP secp256k1

40609.0k117](/packages/kornrunner-secp256k1)

PHPackages © 2026

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