Beheer van de configuratie van je site
Drupal slaat de configuratiegegevens van de site op een consistente manier op — van de lijst met ingeschakelde modules tot de inhoudstypen, taxonomie-woordenlijsten, velden en weergaven.
Het wordt niet aanbevolen om configuratiewijzigingen rechtstreeks op een actieve (live) site aan te brengen. Het systeem is ontworpen zodat je eenvoudig de huidige configuratie kunt gebruiken, lokaal wijzigingen kunt testen, ze kunt exporteren naar bestanden en vervolgens kunt implementeren in de productieomgeving. De configuratie van je site kan worden opgeslagen als onderdeel van je codebasis en geïntegreerd met versiebeheer.
Standaard wordt de “actieve” configuratie opgeslagen in de database (de tabel “config”). Dit gebeurt om prestaties en veiligheid te optimaliseren. Dit is de volledige configuratie van de hele site op het huidige moment. De configuratie kan worden geëxporteerd en geïmporteerd als YAML-bestanden — volledig of als afzonderlijke configuratie-items — met behulp van Drush- en/of Drupal Console-commando’s of via de Configuration Manager. (Zie de details hieronder.)
Het exporteren en importeren van configuratiewijzigingen tussen Drupal-installaties in verschillende omgevingen, zoals Ontwikkeling, Test en Productie, stelt je in staat om wijzigingen veilig te testen voordat je ze toepast in de live omgeving.
Dit maakt het mogelijk om configuratie van de ene omgeving naar de andere te implementeren. (Als voorzorgsmaatregel controleert Drupal of het om dezelfde site gaat vóór de import, door de UUID te vergelijken.)
Configuratiebestanden van modules en thema’s
De standaardconfiguratie die wordt geleverd met modules, distributies en thema’s, wordt geïmporteerd in de actieve configuratieopslag zodra de extensies zijn ingeschakeld. De standaardconfiguratie van een extensie bevindt zich in de map config/install.
Hoe te importeren, exporteren en synchroniseren
Met de kernmodule Configuration Manager kun je de configuratie van de site importeren, exporteren en synchroniseren via Beheer > Configuratie > Ontwikkeling > Configuratiesynchronisatie (admin/config/development/configuration). Je kunt de wijzigingen bekijken voordat je ze importeert.
Je kunt ook één enkel configuratieobject importeren of exporteren met behulp van de kopieer-en-plakworkflow. Dit is handig als je bijvoorbeeld slechts één weergave van de ene naar de andere omgeving wilt verplaatsen.
Daarnaast kun je de volledige siteconfiguratie exporteren als YAML-bestanden in een gecomprimeerd tar.gz-bestand. Dit werkt alleen wanneer je de configuratie tussen twee kopieën van dezelfde site verplaatst (bijvoorbeeld dev en productie), en daarom moeten de UUID’s van beide sites overeenkomen.
Om de UUID van de site via de CLI te controleren:
- Met Drush
drush cget system.site
- Met Drupal Console
drupal debug:config system.site
Voorbeelden van volledige configuratiesynchronisatieworkflows:
Na het voltooien van de synchronisatie worden alle wijzigingen toegepast, zoals het inschakelen van nieuwe modules, velden of inhoudstypen. Kortom, alle configuratiewijzigingen die op de ontwikkelsite zijn gemaakt, worden nu actief op de live site.
Meer informatie
Als je meer gedetailleerde informatie nodig hebt over het configuratiebeheersysteem in Drupal 8, kun je de documentatiepagina’s van de Configuratie-API raadplegen.
Wat je wel en niet moet doen
WEL DOEN:
Het wordt sterk aanbevolen om een database-dump te maken vóór elke synchronisatie van staging- en actieve mappen. Een database-dump kan “je redding zijn” als je later moet terugdraaien.
NIET DOEN:
Probeer niet om de actieve configuratie van je site te wijzigen door bestanden in de map config/install van een module aan te passen.
Dit zal NIET werken, omdat Drupal alleen uit die map leest wanneer de module wordt geïnstalleerd.
Om configuraties “live” te bewerken, gebruik drush config-edit of drupal config:edit.