Quelltext der Seite Doctrine (PHP)

{{Infobox Software
| Name = Doctrine
| Logo = 
| Screenshot = 
| Beschreibung = 
| Maintainer = 
| Hersteller = 
| Erscheinungsjahr = 
| AktuelleVersion = 2.10.3
| AktuelleVersionFreigabeDatum = 3. Dezember 2021
| AktuelleVorabVersion = 3.0
| AktuelleVorabVersionFreigabeDatum = 
| Betriebssystem = 
| Programmiersprache = [[PHP]]
| Kategorie = [[Framework]], [[Objektrelationale Abbildung|Objektrelationaler Mapper]]
| Lizenz = [[MIT-Lizenz]]
| Deutsch = 
| Website = [https://www.doctrine-project.org/ www.doctrine-project.org]
| Dateien = 
}}

Das '''Doctrine Project''' oder kurz '''Doctrine''' ist ein [[Framework]], das die Möglichkeit der [[Objektrelationale Abbildung|objektrelationalen Abbildung]] ({{enS|''object-relational mapping''}}, ''ORM'') sowie eine [[Datenbankabstraktionsschicht]] ({{enS|''database abstraction layer''}}) für [[PHP]] ab Version 5.3 bereitstellt. Dadurch ist ein vereinfachter Zugriff auf verschiedene Datenbanktypen (z.&nbsp;B. [[MySQL]] oder [[Microsoft SQL Server]]) möglich, als dies mit reinem PHP möglich wäre. Doctrine orientiert sich an [[Hibernate (Framework)|Hibernate]], einem ähnlichen Projekt für [[Java (Programmiersprache)|Java]].

Datenbankabfragen können in der Doctrine-eigenen Zwischensprache ''Doctrine Query Language'' (DQL) formuliert werden. Der objektorientierte Ansatz ermöglicht ein abstraktes Arbeiten unabhängig von der verwendeten Datenbank. Auch können Datenbankinhalte objektorientiert verwaltet werden, ohne einen [[Wrapper (Software)|Wrapper]] dafür bereitzustellen. Die objektrelationale Funktionalität wird hier den Objekten selbst zugewiesen, ohne dass eine aufwändige Programmierung in PHP notwendig ist.

Da der DBAL mehrere Datenbankserver ansprechen kann, umfasst DQL nur die Menge an SQL-Funktionalität, die in allen von Doctrine unterstützten SQL-Systemen verfügbar sind. Dadurch sind beispielsweise komplexere [[SQL#Inner|Joins]] nicht immer möglich. Zudem hat Doctrine strikte Einschränkungen bezüglich des Aufbaus der Datenbanken. So muss z.&nbsp;B. jede Tabelle zwingend einen [[Schlüssel (Datenbank)|Primärschlüssel]] aufweisen. Dadurch kann es insbesondere mit großen Bestandsdatenbanken, die vorher mit regulärem SQL gepflegt wurden, zu Problemen kommen.

== Anwendungsbeispiel ==

Wenn als Beispiel ein neues Benutzerobjekt in der Datenbank erstellt werden soll, könnte das in PHP geschrieben wie folgt aussehen:
<syntaxhighlight lang="php">
 $user = new User();
 $user->setName("Max");
 $user->setPassword("test");
 $entityManager->persist($user);
 $entityManager->flush();
 echo "Der Benutzer mit der ID ".$user->getId()." wurde erfolgreich hinzugefügt.";
</syntaxhighlight>

Hierbei wird der sogenannte [[Entity Manager]] von Doctrine angewiesen, ein Objekt ([[Model View Controller#Modell (model)|Model]]) zu speichern. Der Entity Manager verwaltet Models und dient als Schnittstelle zur Datenbank.

== Weblinks ==

* [https://www.doctrine-project.org doctrine-project.org]

[[Kategorie:PHP-Bibliothek]]