Aperçu de l’API base de données

L’API base de données de Drupal 8 fournit un niveau d’abstraction standard, indépendant du fournisseur, pour accéder aux serveurs de base de données. Vous ne devez presque jamais effectuer d’appels directs à la base de données, sauf si vous développez les API fondamentales.

L’API est conçue pour préserver au maximum la syntaxe et la puissance du SQL, mais aussi :

• Faciliter la prise en charge de plusieurs serveurs de base de données ;
• Permettre aux développeurs d’utiliser des fonctionnalités avancées telles que les transactions ;
• Fournir une interface structurée pour la construction dynamique de requêtes ;
• Assurer la validation de sécurité et d’autres bonnes pratiques ;
• Offrir aux modules une interface propre pour intercepter et modifier les requêtes du site.

La documentation principale de l’API base de données provient directement des commentaires dans le code. Cette section du Guide complète cette documentation API en fournissant un tutoriel pour les auteurs de modules souhaitant interagir avec le système de base de données, ainsi qu’un aperçu du système du point de vue de l’administrateur.

L’API base de données a été construite selon des concepts de conception orientée objet, et ce document suppose donc une familiarité, au moins partielle, avec ces concepts. Les opérations courantes disposent aussi d’un style procédural accessible, mais ces styles procéduraux ne sont pas recommandés. Il est conseillé d’utiliser l’objet de connexion pour interagir avec la base de données.

Notez que l’API base de données n’est pas toujours la meilleure option pour interagir avec les données. L’usage de l’API dans Drupal 8 est souvent situationnel, par exemple l’utilisation de l’API Node pour les opérations CRUD sur les nœuds, l’API Entity pour la création d’entités, etc. Veuillez consulter la documentation des API pour déterminer quelle API correspond le mieux à vos besoins.

Remarque : ce guide ne couvre pas forcément toutes les fonctionnalités de l’API.