Drupal 8/9 aus vorhandener Konfiguration installieren

Seit Drupal 8.6 wird kein zusätzliches Modul (wie etwa config_installer mehr benötigt), wenn Drupal auf Basis einer bestehenden (exportierten) Konfiguration installiert werden soll.
Dies ist zum Beispiel hilfreich, wenn bei einem Projekt kein Datenbank Dump ausgetauscht werden soll, sondern alle Entwickler ihre Instanz über eine frische Drupal Installation aufsetzen oder für das Ausführen von automatischen Tests.

Drupal schaut bei der Installation an zwei Orten, ob eine Konfiguration vorhanden ist:

  • In der settings.php ist die Variable $settings['config_sync_directory'] gesetzt. Dies muss vor dem Ausführen der Installation gemacht werden.
  • In dem Installationsprofil – das bei der Installation verwendet wird – befindet sich ein Verzeichnis config/sync, welches die Konfiguration enthält.
    • Hierbei ist jedoch zu beachten (sofern die Konfiguration für ein eigenes Installationsprofil erstellt wird), dass in der core.extension Konfiguration das dortige Installationsprofil geändert werden muss: Dort muss das eigene Profil eingetragen sein und nicht das ursprüngliche Installationsprofil. Dies betrifft zwei Stellen:
      • Beim Key profile
      • Bei der Liste der Module (Key module)

Drush

Drush unterstützt ab Version 9.4 auch die direkte Installation aus vorhandener Konfiguration: drush site:install --existing-config. Auch hier muss der Pfad zu der Konfiguration in der settings.php vorab gesetzt sein: $settings['config_sync_directory']

Es gibt bei der Installation über Drush jedoch die Einschränkung, dass die Konfiguration auf dem „minimal“ Installationsprofil basiert. Ansonsten kommt es zu der Fehlermeldung:

Einschränkung hinsichtlich hook_install()

Derzeit kann eine neue Drupal Installation aus einer vorhanden Konfiguration nur installiert werden, wenn das verwendete Installationsprofil keinen hook_install() verwendet. Beispielsweise benutzt das „standard“ Profil diesen Hook, weshalb es hier zu einer Fehlermeldung kommt, wenn mit dieser Konfiguration eine Installation durchgeführt wird:

Configuration install: standard
The selected profile has a hook_install() implementation and therefore can not be installed from configuration.

Die einfachste Lösung dies zu beheben ist es, die core.extension.yml anzupassen und hier ein anderes Installationsprofil zu verwenden (welches ohne hook_install() auskommt):

module:
  [...]
  views: 10
  standard: 1000
profile: standard
core:
  _default_config_hash: [...]

wird geändert zu:

module:
  [...]
  views: 10
  minimal: 1000
profile: minimal
core:
  _default_config_hash: [...]

Diese Einschränkung wird möglicherweise mit den nächsten Drupal Versionen entfallen: Allow an install hook in profiles installing from configuration