1. Doctrine 2 ORM

2. ORM?

3. Object Relational
Mapping

4. Objektgraph Tabellen &
Relationen

5. Doctrine 2?

6. Doctrine 2
Code-Bibliothek für PHP >= 5.3.2
Inspiriert von JPA & Hibernate
Von den Machern von Symfony
De-Facto Standard für ORM in PHP
Für MySQL & Co., aber ...

7. Doctrine 2
... funktioniert auch mit CouchDB, MongoDB
& Co.
ORM trifft es daher eigentlich gar nicht
(mehr)
Ziel: „Mach dir keine Sorgen mehr um die
Persistenz deiner Objekte.“

8. Doctrine „Projects“
Ab hier
ORM
wird‘s cool.
DBAL
Common

9. Common
Class Loading
Annotations

10. DBAL
Wrapper um PDO
Verbindungsmanagement
SQL-Query Builder
Events (z.B. PostConnect)
Schema Manager
…

11. ORM
Persistenz für PHP Objekte
Objekt-Orientierte Abfragesprache (DQL)

12. Installation
Via archive download, git clone oder PEAR
Setup Autoloader
Entity Manager mit Konfigurationsobjekt
initialisieren (DB-Infos, Caching, Pfade, etc.)
(alle Details im Manual)

13. Exkurs: ZF-Boilerplate
Zend Framework
Development
Plattform
ZF + Doctrine 2 +
PHPUnit + Vagrant +
ElasticSearch + ...
Virtual Box
Open Source

14. Exkurs: ZF-Boilerplate
Installation Ruby + Vagrant + Virtual Box lokal
git clone https://michael-romer@github.com/michael-
romer/zf-boilerplate.git myApp
$ vagrant box add lucid32 http://files.vagrantup.com/
lucid32.box
$ vagrant up
http://localhost:8080 im Browser aufrufen

15. ORM Akteure
EntityManager
Entity Repository

16. Entity
POPO (= Plain Old PHP Object)
Keine Persistenz-Basisklasse (mehr)
notwendig
Meta-Informationen zur Persistenz als
Annotationen (XML, YAML ebenfalls möglich)
Tabellen-Ebene
Feld-Ebene
Assoziationen

17. Klasse „App“

18. Entity „App“

19. Entity Manager
Konfigurierte Klasse zum Lifecycle-
Management der Entities.
Verbindungdaten
Caching-Konfiguration
MetaData-Driver (z.B. Annotations oder
YAML)
…

20. Entity Manager

21. Entity Manager
Internals
Unit-of-Work Pattern
Verfolgt Änderungen via
Identity Map mit Objektkopien
Dank PHP‘s „Copy-On-Write“
resourcenschonend
Wiederholtes Laden einer
Entity aus Map

22. Repository
Laden von Entities via Repositories
Default-Repository für Entities
findAll, findOne, findBy, findOneBy, ...
Custom-Repositories halten alle DB-Queries

23. Repository

24. Entity „App“ mit Custom
Repo

25. DQL (Doctrine Query
Language)
Abfragesprache, angelehnt an SQL, aber
„objektorientiert“ formuliert
Vereinfacht Umgang mit Objekteigenschaften
und Assoziationen

26. Assoziationen
Analog zu Objekteigenschaften durch
Annotationen kenntlich gemacht
1-1, 1-n und n-n, self-referencing, uni- und
bidirektionale Assoziationen
Support für Composite Keys

27. Assoziationen

28. Assoziationen

29. Assoziationen

30. Entity Proxies
Wird eine App aus der DB geladen, wird
standardmäßig nicht die Users collection
mitgeladen.
Doctrine generiert Proxy-Klassen, die
stellvertretend verwendet werden (instanceof
User == true), bis die Entity tatsächlich
verwendet wird.
Wird eine Assoziation (e.g. foreach)
traversiert, erkennt dies Doctrine und lädt
alle Entities.

31. Vererbung
Unterstützung für
Mapped Superclass
„Daten-Mixin“
Single Table Inheritence
Alle Klassen der Hierarchie in einer Tabelle abgebildet
Descriminator Column zur Klassenbestimmung
Keine Joins notwendig
Class Table Inheritence
Jede Klasse hat eigene Tabelle mit individuellen Eigenschaften

32. Events
Eventsystem für „Custom-Events“
Entity-Lifecycle-Events
preRemove, postRemove, prePersist ,
postPersist, preUpdate, postUpdate, postLoad,
loadClassMetadata, onFlush, onClear

33. SQL
Native SQL Abfragen bei Bedarf möglich
Custom Mapping von Spalten auf
Eigenschaften
Ggf. Partial Objects zwecks Performance-
Optimierung

34. Caching
Drivers
Array
APC
Memcached
XCache
Arten
DQL Query Cache (SQL Statements)
Result Cache (Entites)
Metadata Cache (Annotationen, YAML, etc.)

35. DQL, Teil 2
Unterstützung für
Aggregationen (z.B. COUNT)
Funktionen (z.B. CONCAT)
Operatoren (z.B. Arithmetik)

36. Transaktionen
Implizit durch „Unit-of-Work“
Explizit durch

37. Locking
Support für „User-Think-Time“ Locking
Optimistisch
„Es wird schon gutgehen!“
Versions-Feld (int oder timestamp)
Wirft ggf. Exception
Pessimistisch
„Lieber nichts riskieren!“
Nur auf DB-Ebene

38. Doctrine Console (CLI)
Installation via PEAR (oder manuell)
Standard-Kommandos + Eigene Kommandos
(analog Zend_Tool)
Doctrine Console
$ doctrine orm:generate-entities --help
z.B. $ dbal:import / Import SQL file(s) in DB
/
z.B. $ php doctrine.php orm:schema-
tool:create / Erzeugung DB Schema
/

39. Extensions
Doctrine Extensions (Behavior)
Versionable
Sortable
Loggable
Translateable
Tree / Nested Set
…
https://github.com/l3pp4rd/DoctrineExtensions
https://github.com/beberlei/DoctrineExtensions

40. Fin
Doctrine 2: http://www.doctrine-project.org/
Enterprise Patterns: http://martinfowler.com/
ZF-Boilerplate: http://zf-boilerplate.com
Mein Blog: http://www.startup-patterns.de/