Overzicht van de Configuratie-API
De Configuratie-API biedt een centrale plek voor modules om configuratiegegevens op te slaan. Deze gegevens kunnen eenvoudige configuratie zijn, zoals de naam van uw site, of meer complexe informatie die wordt beheerd met configuratieobjecten, zoals Views en contenttypes.
Configuratie is de plek om informatie op te slaan die u wilt synchroniseren van ontwikkeling naar productie. Deze informatie wordt vaak aangemaakt tijdens het bouwen van de site en meestal niet door gewone gebruikers gegenereerd tijdens normaal gebruik van de site.
U moet de State API gebruiken, en niet configuratie, voor het opslaan van lokale variabelen die niet tussen installaties mogen worden verplaatst. Gebruik state voor verborgen systeemwaarden, en als u deze nooit wilt uitrollen tussen omgevingen. U kunt het systeem opnieuw laden en al het state verliezen. De configuratie blijft behouden.
De Configuratie-API wordt geleverd in twee varianten: de (eenvoudige) Config API en de Configuration Entity API. Het belangrijkste verschil is dat de Config API bedoeld is voor gebruik met één instantie. Een singleton is een configuratie waarvan er slechts één exemplaar kan bestaan. Een goed voorbeeld is de sitenaam.
De Configuration Entity API moet worden gebruikt voor het opslaan van meerdere configuratiesets – bijvoorbeeld node types, Views, vocabularia en velden.
Het bijwerken van de Configuratie-API is cruciaal om fatale fouten te voorkomen bij het upgraden van thema’s en modules om te werken in Drupal 8. Zie Thema-updates en informatie over module-updates.