Überblick über die Datenbank-API

Die Datenbank-API von Drupal 8 bietet eine standardisierte, anbieterunabhängige Abstraktionsebene für den Zugriff auf Datenbankserver. Sie sollten fast nie direkt Datenbankaufrufe tätigen, außer Sie entwickeln Kern-APIs.

Die API ist so gestaltet, dass sie die Syntax und Leistungsfähigkeit von SQL bestmöglich erhält, gleichzeitig aber:

• Die einfache Unterstützung mehrerer Datenbankserver ermöglicht;
• Entwicklern erlaubt, komplexere Funktionen wie Transaktionen zu nutzen;
• Einen strukturierten Interface für den dynamischen Aufbau von Abfragen bereitstellt;
• Für Sicherheitsprüfungen und andere bewährte Praktiken sorgt;
• Modulen eine saubere Schnittstelle bietet, um Anfragen der Seite abzufangen und zu verändern.

Die Hauptdokumentation zur Datenbank-API stammt direkt aus Kommentaren im Code. Dieser Abschnitt des Handbuchs ergänzt diese API-Dokumente, indem er ein Tutorial für Modulautoren bereitstellt, die mit dem Datenbanksystem interagieren möchten, sowie einen Überblick aus Administratorsicht.

Die Datenbank-API wurde unter Verwendung objektorientierter Designkonzepte entwickelt, weshalb dieses Dokument zumindest teilweise Vertrautheit mit diesen Konzepten voraussetzt. Gewöhnliche Operationen sind auch im prozeduralen Stil verfügbar, werden aber nicht empfohlen. Für die Interaktion mit der Datenbank wird die Verwendung des Verbindungsobjekts empfohlen.

Beachten Sie, dass die Datenbank-API nicht immer die beste Wahl für den Umgang mit Daten ist. Der Einsatz der API in Drupal 8 ist oft situationsabhängig, zum Beispiel die Verwendung der Node-API für Node-CRUD-Operationen, der Entity-API für die Erstellung von Entities usw. Bitte prüfen Sie die API-Dokumentationen, um festzustellen, welche API am besten zu Ihren Anforderungen passt.

Hinweis: Dieses Handbuch deckt möglicherweise nicht alle Funktionen der API ab.