Overzicht van de Database API

De Database API van Drupal 8 biedt een standaard, leverancier-onafhankelijke abstractielaag voor toegang tot databaseservers. Je zou bijna nooit rechtstreeks database-aanroepen moeten doen, tenzij je kern-API’s ontwikkelt.

De API is ontworpen om zoveel mogelijk de syntaxis en kracht van SQL te behouden, maar ook om:

• Eenvoudig meerdere databaseservers te ondersteunen;
• Ontwikkelaars in staat te stellen complexere functies zoals transacties te gebruiken;
• Een gestructureerde interface te bieden voor het dynamisch opbouwen van queries;
• Zorg te dragen voor veiligheidscontroles en andere best practices;
• Modules een nette interface te geven om queries van de site te onderscheppen en aan te passen.

De kern Database API documentatie wordt rechtstreeks gegenereerd uit commentaar in de code. Deze sectie van de handleiding vult die API-documentatie aan door een tutorial te bieden voor moduleontwikkelaars die met het databasesysteem willen werken, evenals een overzicht van het systeem vanuit het perspectief van een beheerder.

De Database API is opgebouwd met objectgeoriënteerde ontwerpbeginselen, en dit document gaat er daarom vanuit dat je ten minste gedeeltelijk bekend bent met die concepten. Voor veelgebruikte bewerkingen zijn er ook procedurele stijlen beschikbaar, maar deze worden afgeraden. Voor database-interactie wordt het gebruik van het connectie-object aanbevolen.

Merk op dat de Database API niet altijd de beste optie is voor datainteractie. Het gebruik van API’s in Drupal 8 is vaak situationeel, bijvoorbeeld het gebruik van de Node API voor Node CRUD-operaties, of de Entity API voor het maken van Entities, enzovoort. Raadpleeg de API-documentatie om te bepalen welke API het beste aansluit bij jouw behoeften.

Opmerking: deze handleiding dekt mogelijk niet alle functies van de API.