PHPackages                             philiprehberger/php-dto-mapper - 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. philiprehberger/php-dto-mapper

ActiveLibrary

philiprehberger/php-dto-mapper
==============================

Map arrays and JSON to strongly-typed DTOs with attribute-driven configuration

v1.0.3(4d ago)11MITPHPPHP ^8.2CI passing

Since Mar 15Pushed 4d agoCompare

[ Source](https://github.com/philiprehberger/php-dto-mapper)[ Packagist](https://packagist.org/packages/philiprehberger/php-dto-mapper)[ Docs](https://github.com/philiprehberger/php-dto-mapper)[ RSS](/packages/philiprehberger-php-dto-mapper/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (3)Versions (5)Used By (0)

PHP DTO Mapper
==============

[](#php-dto-mapper)

[![Tests](https://github.com/philiprehberger/php-dto-mapper/actions/workflows/tests.yml/badge.svg)](https://github.com/philiprehberger/php-dto-mapper/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/4b4b0a2025b26d7a29a380a679ce8f1ba835f31965a2484b0bcb788869b99153/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068696c69707265686265726765722f7068702d64746f2d6d61707065722e737667)](https://packagist.org/packages/philiprehberger/php-dto-mapper)[![License](https://camo.githubusercontent.com/94713e477c369227bfff305940915d30006bdfa61bab054186053debb9f70b4a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7068696c69707265686265726765722f7068702d64746f2d6d6170706572)](LICENSE)

Map arrays and JSON to strongly-typed DTOs with attribute-driven configuration.

---

Requirements
------------

[](#requirements)

DependencyVersionPHP^8.2Zero external dependencies.

---

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

[](#installation)

```
composer require philiprehberger/php-dto-mapper
```

---

Usage
-----

[](#usage)

### Define a DTO

[](#define-a-dto)

```
use PhilipRehberger\DtoMapper\Attributes\MapFrom;
use PhilipRehberger\DtoMapper\Attributes\Optional;
use PhilipRehberger\DtoMapper\Attributes\CastWith;
use PhilipRehberger\DtoMapper\Casters\DateTimeCaster;

class UserDto
{
    public function __construct(
        public readonly string $name,
        #[MapFrom('email_address')]
        public readonly string $email,
        #[Optional]
        public readonly ?string $nickname = null,
        #[CastWith(DateTimeCaster::class)]
        public readonly ?\DateTimeImmutable $createdAt = null,
    ) {}
}
```

### Map from array

[](#map-from-array)

```
use PhilipRehberger\DtoMapper\DtoMapper;

$dto = DtoMapper::map([
    'name' => 'John',
    'email_address' => 'john@example.com',
    'createdAt' => '2026-01-15 10:30:00',
], UserDto::class);

$dto->name;      // 'John'
$dto->email;     // 'john@example.com'
$dto->createdAt; // DateTimeImmutable
```

### Map from JSON

[](#map-from-json)

```
$dto = DtoMapper::mapJson('{"name": "Jane", "email_address": "jane@example.com"}', UserDto::class);
```

### Map a collection

[](#map-a-collection)

```
$dtos = DtoMapper::mapCollection([
    ['name' => 'Alice', 'email_address' => 'alice@example.com'],
    ['name' => 'Bob', 'email_address' => 'bob@example.com'],
], UserDto::class);
```

### Safe mapping

[](#safe-mapping)

```
$dto = DtoMapper::tryMap($data, UserDto::class); // Returns null on failure
```

### Nested DTOs

[](#nested-dtos)

```
class AddressDto
{
    public function __construct(
        public readonly string $street,
        public readonly string $city,
    ) {}
}

class PersonDto
{
    public function __construct(
        public readonly string $name,
        public readonly AddressDto $address,
    ) {}
}

$dto = DtoMapper::map([
    'name' => 'Alice',
    'address' => ['street' => '123 Main St', 'city' => 'Springfield'],
], PersonDto::class);

$dto->address->city; // 'Springfield'
```

### Custom casters

[](#custom-casters)

Implement the `Caster` interface:

```
use PhilipRehberger\DtoMapper\Contracts\Caster;

class MoneyFromCentsCaster implements Caster
{
    public function cast(mixed $value): float
    {
        return (int) $value / 100;
    }
}
```

Use with the `#[CastWith]` attribute:

```
class OrderDto
{
    public function __construct(
        #[CastWith(MoneyFromCentsCaster::class)]
        public readonly float $total,
    ) {}
}
```

### Enum casting

[](#enum-casting)

```
use PhilipRehberger\DtoMapper\Attributes\CastWith;
use PhilipRehberger\DtoMapper\Casters\EnumCaster;

enum Status: string
{
    case Active = 'active';
    case Inactive = 'inactive';
}

class AccountDto
{
    public function __construct(
        public readonly string $name,
        #[CastWith(EnumCaster::class, args: [Status::class])]
        public readonly Status $status,
    ) {}
}
```

---

API
---

[](#api)

MethodDescription`DtoMapper::map(array $data, string $class): object`Map an associative array to a DTO`DtoMapper::mapJson(string $json, string $class): object`Map a JSON string to a DTO`DtoMapper::mapCollection(array $items, string $class): array`Map an array of arrays to DTOs`DtoMapper::tryMap(array $data, string $class): ?object`Map returning null on failure### Attributes

[](#attributes)

AttributeTargetDescription`#[MapFrom('key')]`PropertyMap from a different source key`#[Optional]`PropertyAllow missing keys, use default value`#[CastWith(Caster::class)]`PropertyApply a custom caster### Built-in Casters

[](#built-in-casters)

CasterDescription`DateTimeCaster`Casts string to `DateTimeImmutable``EnumCaster`Casts string/int to a backed enum---

Development
-----------

[](#development)

```
composer install
vendor/bin/phpunit
vendor/bin/pint --test
vendor/bin/phpstan analyse
```

License
-------

[](#license)

MIT

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance99

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

Total

4

Last Release

4d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

mapperdtocastinghydrationdata-transfer

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/philiprehberger-php-dto-mapper/health.svg)

```
[![Health](https://phpackages.com/badges/philiprehberger-php-dto-mapper/health.svg)](https://phpackages.com/packages/philiprehberger-php-dto-mapper)
```

###  Alternatives

[eventsauce/object-hydrator

Converts structured data into strict objects.

3322.2M12](/packages/eventsauce-object-hydrator)[brick/json-mapper

Maps JSON data to strongly typed PHP DTOs

20546.4k1](/packages/brick-json-mapper)[rekalogika/mapper

An object mapper for PHP and Symfony. Maps an object to another object. Primarily used for transforming an entity to a DTO and vice versa.

3846.0k1](/packages/rekalogika-mapper)[idr0id/papper

Papper is PHP convention-based object to object mapper

4926.9k1](/packages/idr0id-papper)[nutgram/hydrator

Hydrator for PHP 8.0+

12246.8k5](/packages/nutgram-hydrator)[artyuum/request-dto-mapper-bundle

This bundle provides an easy way to automatically map the incoming request data to a DTO and optionally validate it.

515.8k](/packages/artyuum-request-dto-mapper-bundle)

PHPackages © 2026

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