Hand-Rolled Mappers vs AutoMapper: Keeping the PHP Domain Pure at the Boundary

A 20-line entity-to-row mapper you can read beats a reflection mapper you can't. Here is why explicit mapping protects the domain.

sabato 13 giugno 2026 New tab

TL;DRAI

Reflection mappers couple database to domain via name-matching; discount_cents fields silently reach Money as null, breaking invariants. Hand-rolled mappers require explicit translation but create schema firewalls that prevent silent corruption on migrations—spending friction now rather than debugging later.

1,381 words~6 min read

Book: Decoupled PHP — Clean and Hexagonal Architecture for Applications That Outlive the Framework

Also by me: Thinking in Go (2-book series) — Complete Guide to Go Programming + Hexagonal Architecture in Go

My project: Hermes IDE | GitHub — an IDE for developers who ship with Claude Code and other AI coding tools

Me: xgabriel.com | GitHub

You add a column to a table. discount_cents, nullable, default zero. A small migration, a five-minute ticket. The next morning a teammate pings you: orders placed overnight have a discount of null where the domain expected zero, and the total calculation now throws a TypeError deep inside a value object.

Hand-Rolled Mappers vs AutoMapper: Keeping the PHP Domain Pure at the Boundary

Hand-Rolled Mappers vs AutoMapper: Keeping the PHP Domain Pure at the Boundary

Related reading

Translate Infrastructure Errors at the Adapter, Not in Your Domain

Why `mixed` Is the Worst Type in Your PHP Codebase (and How to Kill It)

PHP 8.4 Asymmetric Visibility: 5 Patterns That Replace Constructors and Setters

PHP Fibers in Production: 4 Real Cases Where They Beat curl_multi and Queues

🧩 Your MapStruct Mappers Are Hiding Null Bugs

How I stopped hardcoding business rules in PHP - and built a rule engine to fix…

Related reading

Translate Infrastructure Errors at the Adapter, Not in Your Domain

Why `mixed` Is the Worst Type in Your PHP Codebase (and How to Kill It)

PHP 8.4 Asymmetric Visibility: 5 Patterns That Replace Constructors and Setters

PHP Fibers in Production: 4 Real Cases Where They Beat curl_multi and Queues

🧩 Your MapStruct Mappers Are Hiding Null Bugs

How I stopped hardcoding business rules in PHP - and built a rule engine to fix…