Cette page décrit l’API pour accéder et configurer des données de configuration simple. (Ce n’est pas pour les informations stockées dans les objets de configuration.)

Utiliser $config dans le contexte d’un formulaire

Vous pouvez utiliser les formulaires de configuration pour comprendre comment $config peut récupérer les données saisies par l’utilisateur et modifier les données dans le fichier {module}.settings.yml. Voici le code pour déclarer l’objet $config dans un formulaire, que vous trouverez dans le fichier PHP du formulaire de configuration.

Documentation sur l’API de la base de données dans Drupal 8.

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 :

Le niveau base de données de Drupal est construit au-dessus de la bibliothèque PDO de PHP. PDO fournit une API orientée objet unifiée pour accéder à différentes bases de données, mais ne propose pas d’abstraction des différents dialectes SQL utilisés par ces bases.

Le principal moyen de définir la connexion à une base de données est le tableau $databases dans settings.php. Comme son nom l’indique, $databases permet de définir plusieurs connexions aux bases de données. Il supporte aussi la définition de plusieurs cibles. La connexion à la base de données n’est pas ouverte (l’objet connexion n’est pas créé) tant que le premier morceau de code n’essaie pas d’exécuter une requête sur cette base de données.

Clé de connexion

L’interaction avec la base de données doit se faire via un objet de connexion à la base de données. Plusieurs scénarios nécessitent une attention particulière :

1. Dans un code procédural, par exemple les fichiers *.module, *.inc ou scripts :
La meilleure façon de créer une instance de l’objet de connexion à la base de données est d’utiliser le Service Container.

Exemple :

Les requêtes SELECT les plus courantes dans Drupal sont des requêtes statiques utilisant la méthode query() de l’objet de connexion à la base de données.
Les requêtes statiques sont transmises à la base de données presque telles quelles.

Exemple :

Dans cette section, nous allons voir comment travailler avec un thème dans Drupal 8.

Pour créer un thème Drupal 8, il faut d’abord créer un fichier THEMENAME.info.yml qui fournit les métadonnées de votre thème à Drupal. Cela ressemble à la manière dont sont définis les modules et les profils d’installation, il est donc important de définir la clé type dans le fichier .info.yml comme theme afin de bien le distinguer.

Cette page contient un exemple de fichier THEMENAME.info.yml et un aperçu des informations que ce fichier peut contenir.