Ändern des Verzeichnisses für die Konfigurationssynchronisation

Standardmäßig legt Drupal das Verzeichnis für die Konfigurationssynchronisation im Verzeichnis der Site-Dateien ab und verwendet dabei einen Hash als Teil des Verzeichnisnamens, z. B. sites/default/files/config_HASH.

Der HASH ist eine ziemlich lange Zeichenkette aus zufälligen Symbolen. Dies erschwert (macht aber nicht unmöglich) den Zugriff auf die Konfiguration über das Internet. Der Speicherort des Synchronisationsverzeichnisses kann nach der Installation geändert werden.

Auf Produktionsseiten und wenn Ihr Benutzerkonto die Berechtigung dazu hat, wird empfohlen, das Synchronisationsverzeichnis komplett außerhalb des Web-Stammverzeichnisses zu verschieben. Da Ihr Synchronisationsverzeichnis unter Versionskontrolle stehen sollte, bedeutet dies, dass das Stammverzeichnis Ihres Versionskontrollsystems eine Ebene über dem Web-Stammverzeichnis liegen sollte.

Bei lokalen Entwicklungsseiten möchten Sie möglicherweise einen leichteren Zugriff auf die Konfigurationsdateien haben und das Verzeichnis beispielsweise nach sites/default/sync verschieben.

Um das Verzeichnis zu verschieben, öffnen Sie Ihre Datei settings.php. Am Ende der Datei schreibt der Drupal-Installationsprozess eine Zeile mit dem Speicherort des Synchronisationsverzeichnisses in sites/default/files/config_HASH.

Das Fehlen eines Synchronisationsverzeichnisses kann zu folgender Fehlermeldung im PHP-Error-Log führen: 

Uncaught PHP Exception Exception: "The configuration directory type 'sync' does not exist"

Wenn Sie diesen Ordner zum Beispiel nach sites/default/sync verschieben möchten, müssen Sie die Variable $config_directories wie folgt aktualisieren:

$config_directories[CONFIG_SYNC_DIRECTORY] = 'sites/default/sync';

Wenn Sie den Ordner außerhalb des Web-Stammverzeichnisses verschieben möchten, können Sie etwas wie Folgendes verwenden:

$config_directories[CONFIG_SYNC_DIRECTORY] = '../config/sync';

Dabei hat das Verzeichnis config denselben übergeordneten Ordner wie Ihr Web-Stammverzeichnis, und das Verzeichnis sync befindet sich im config-Ordner.

Das war's! Nun wird über die Konfigurationsverwaltungsoberfläche oder den Drush-basierten Workflow das richtige Verzeichnis verwendet.

Syntaxänderungen in Drupal 8.8.0

In Drupal 8.8.0 ist das Synchronisationsverzeichnis in $settings und nicht mehr in $config_directories definiert, daher muss die Datei settings.php aktualisiert werden.

Ändern Sie einfach von:

$config_directories['sync'] = 'foo/bar';

zu:

$settings['config_sync_directory'] = 'foo/bar';