Vue d'ensemble de l'API de configuration
L’API de configuration fournit un endroit centralisé pour que les modules stockent des données de configuration. Ces données peuvent être une configuration simple, comme le nom de votre site, ou des informations plus complexes gérées via des objets de configuration, comme les vues et les types de contenu.
La configuration est l’endroit où stocker les informations que vous souhaitez synchroniser du développement à la production. Ces informations sont souvent créées lors de la construction du site et ne sont généralement pas générées par les utilisateurs réguliers pendant le fonctionnement normal du site.
Vous devez utiliser l’API d’état, et non la configuration, pour stocker les variables locales qui ne doivent pas être transférées entre instances. Utilisez l’état pour les valeurs système cachées, et si vous ne souhaitez jamais les déployer entre environnements. Vous pouvez réinitialiser le système en perdant tout l’état, tandis que la configuration est persistante.
L’API de configuration existe en deux variantes : l’API Config (simple) et l’API des entités de configuration. La différence clé est que l’API Config concerne des configurations singleton, où un seul exemplaire existe. Un bon exemple est le nom du site.
L’API des entités de configuration est utilisée pour stocker plusieurs ensembles de configurations, comme les types de nœuds, les vues, les vocabulaires et les champs.
La mise à jour de l’API de configuration est cruciale pour éviter les erreurs fatales lors de la mise à jour des thèmes et modules vers Drupal 8. Voir la mise à jour des thèmes et les informations sur la mise à jour des modules.