Was ist ein DTO in PHP und warum braucht man es?

Beim Aufbau von PHP-Anwendungen stehen Entwickler ständig vor der Herausforderung, Daten zwischen verschiedenen Schichten einer Anwendung zu übergeben: Controllern, Services, Repositories und Views. Ein häufiges Anti-Pattern ist die Übergabe von rohen Arrays oder stdClass-Objekten, was zu unklaren Verträgen, versteckten Fehlern und schwierigem Refactoring führt. Genau hier kommen Data Transfer Objects (DTOs) ins Spiel.

Was ist ein DTO?

Ein DTO (Data Transfer Object, Datenübertragungsobjekt) ist ein einfaches Objekt, dessen einziger Zweck darin besteht, Daten zwischen Prozessen oder Schichten einer Anwendung zu transportieren. Es enthält keine Geschäftslogik, keine Validierungsregeln und keine Datenbankabfragen — nur Eigenschaften und Methoden für deren Zugriff.

Der Begriff wurde von Martin Fowler in seinem Buch Patterns of Enterprise Application Architecture populär gemacht. In der PHP-Welt wurden DTOs mit dem Aufstieg von Domain-Driven Design (DDD) und Clean Architecture weit verbreitet.

Warum braucht man DTOs?

Die Verwendung von DTOs anstelle von Arrays oder generischen Objekten bietet mehrere wichtige Vorteile:

Typsicherheit — DTOs haben streng typisierte Eigenschaften, was Fehler frühzeitig erkennt und die IDE-Autovervollständigung verbessert.
Klare Verträge — ein DTO definiert explizit, welche Daten es trägt, im Gegensatz zu einem einfachen Array mit unbekannten Schlüsseln.
Unveränderlichkeit — DTOs können schreibgeschützt gemacht werden, was eine versehentliche Änderung von Daten während ihrer Reise durch das System verhindert.
Kapselung — die Datenstruktur ist von der Geschäftslogik getrennt, was den Code sauber und fokussiert hält.
Einfacheres Refactoring — die Änderung der Struktur eines DTO ist eine Einzelpunktänderung, keine Suche durch Dutzende von Array-Zugriffen.
Selbstdokumentation — die Klasse selbst beschreibt die Form der Daten.

Ein einfaches DTO-Beispiel in PHP

Erstellen wir ein grundlegendes DTO für einen Benutzer:

<?php declare(strict_types=1); final class UserDTO { public function __construct( public readonly int $id, public readonly string $name, public readonly string $email, public readonly int $age, ) { } }

Dank der readonly-Eigenschaften und der Constructor-Promotion in PHP 8.1+ ist dieses DTO prägnant, unveränderlich und typsicher.

Verwendung eines DTO in der Praxis

So könnten Sie ein DTO verwenden, wenn Sie Daten aus einem Repository zurückgeben:

<?php final class UserRepository { public function findById(int $id): ?UserDTO { $row = $this->db->fetchOne('SELECT * FROM users WHERE id = ?', [$id]); if ($row === null) { return null; } return new UserDTO( id: (int) $row['id'], name: $row['name'], email: $row['email'], age: (int) $row['age'], ); } }

Jetzt weiß der aufrufende Code genau, welche Daten er erhält:

<?php $user = $repository->findById(42); if ($user !== null) { echo $user->name; // IDE weiß, dass dies ein String ist echo $user->email; // IDE weiß, dass dies ein String ist }

DTO vs. Value Object vs. Entity

Es ist wichtig, DTOs nicht mit anderen Mustern zu verwechseln:

DTO — trägt Daten, kein Verhalten, keine Identität.
Value Object — unveränderlich, durch seine Werte definiert, kann Verhalten enthalten (z. B. Money, Email).
Entity — hat eine eindeutige Identität und einen Lebenszyklus, enthält Geschäftslogik.

Arrays in DTOs umwandeln

In realen Anwendungen müssen Sie oft ein DTO aus einem Array erstellen, beispielsweise aus einem Request-Payload. Ein üblicher Ansatz ist eine statische Factory-Methode:

<?php final class CreateUserDTO { public function __construct( public readonly string $name, public readonly string $email, public readonly int $age, ) { } public static function fromArray(array $data): self { return new self( name: $data['name'], email: $data['email'], age: (int) $data['age'], ); } }

DTOs und Validierung

DTOs sollten nicht selbst validieren. Halten Sie die Validierung stattdessen in einer dedizierten Schicht, wie einem Form Request oder einem Validator-Service. Das DTO wird erst erstellt, nachdem die Daten validiert wurden.

<?php $data = $request->getParsedBody(); $validator->validate($data, [ 'name' => 'required|string', 'email' => 'required|email', 'age' => 'required|integer|min:18', ]); $dto = CreateUserDTO::fromArray($data);

Wann DTOs übertrieben sein können

DTOs sind nicht immer notwendig. In kleinen Skripten oder Prototypen kann die Verwendung von Arrays völlig in Ordnung sein. Die Einführung von DTOs ist sinnvoll, wenn:

Ihre Anwendung mehrere Schichten mit klaren Grenzen hat.
Daten über Modul- oder Servicegrenzen hinweg übergeben werden.
Sie Typsicherheit und langfristige Wartbarkeit benötigen.
Mehrere Konsumenten dieselbe Datenstruktur nutzen.

Best Practices für DTOs in PHP

Machen Sie sie unveränderlich — verwenden Sie readonly-Eigenschaften oder private Eigenschaften mit Gettern.
Halten Sie sie klein — ein DTO sollte ein klares Konzept repräsentieren.
Keine Geschäftslogik — verschieben Sie jegliche Logik in Services oder Domänenobjekte.
Verwenden Sie strikte Typen — deklarieren Sie strict_types=1 in jeder DTO-Datei.
Bieten Sie Factory-Methoden wie fromArray() oder fromRequest() für eine bequeme Konstruktion.
Vermeiden Sie Setter — ein DTO sollte einmal erstellt und nie geändert werden.

Fazit

DTOs sind ein einfaches, aber leistungsstarkes Muster, das Klarheit, Typsicherheit und Wartbarkeit in PHP-Anwendungen bringt. Sie definieren explizite Verträge zwischen Schichten, reduzieren Fehler durch schwach typisierte Arrays und machen Refactoring deutlich einfacher. Obwohl sie etwas Boilerplate hinzufügen, überwiegen die langfristigen Vorteile in mittleren und großen Projekten bei Weitem die Kosten. Fangen Sie klein an: Führen Sie DTOs dort ein, wo Daten Schichtgrenzen überschreiten, und Sie werden den Unterschied in der Codequalität schnell spüren.

Versuchen Sie noch heute, einen Ihrer array-basierten Datenflüsse in ein DTO zu refactoren — Ihr zukünftiges Ich wird es Ihnen danken.

Technologien & Themen

Artikel-Tags

Keine Artikel entsprechen diesen Filtern.

Was ist ein DTO in PHP und warum braucht man es?

Was ist ein DTO in PHP und warum braucht man es?

Was ist ein DTO?

Warum braucht man DTOs?

Ein einfaches DTO-Beispiel in PHP

Verwendung eines DTO in der Praxis

DTO vs. Value Object vs. Entity

Arrays in DTOs umwandeln

DTOs und Validierung

Wann DTOs übertrieben sein können

Best Practices für DTOs in PHP

Fazit

Artikel-Tags

Haben Sie ein Projekt oder eine Idee zu besprechen?