Modification du répertoire de synchronisation de la configuration

Par défaut, Drupal place le répertoire de synchronisation de la configuration dans le répertoire des fichiers du site, en utilisant un hash comme partie du nom du répertoire, ainsi sites/default/files/config_HASH.

Le HASH est une chaîne assez longue de caractères aléatoires. Cela complique (mais ne rend pas impossible) l'accès à la configuration via Internet. L'emplacement du répertoire de synchronisation peut être modifié après l'installation.

Sur les sites en production, et si votre compte a les permissions nécessaires, il est recommandé de déplacer complètement le répertoire de synchronisation de la configuration en dehors de la racine du site. Puisque votre répertoire de synchronisation doit être sous contrôle de version, cela signifie que le répertoire racine de votre dépôt doit être un niveau au-dessus de la racine du site.

Sur les sites de développement locaux, vous pouvez préférer un accès plus facile aux fichiers de configuration et déplacer le répertoire vers quelque chose comme sites/default/sync.

Pour déplacer le répertoire, ouvrez votre fichier settings.php. À la fin du fichier, le processus d'installation de Drupal écrit une ligne indiquant l'emplacement du répertoire de synchronisation dans sites/default/files/config_HASH.

L'absence du répertoire de synchronisation peut provoquer le message suivant dans le journal des erreurs PHP :

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

Si vous souhaitez déplacer ce dossier, par exemple vers sites/default/sync, vous devez mettre à jour la variable $config_directories comme suit :

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

Si vous souhaitez déplacer le dossier en dehors de la racine web, vous pouvez utiliser quelque chose comme :

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

où le dossier config est au même niveau que votre racine web, et le dossier sync existe dans le dossier config.

Et voilà ! Maintenant, en utilisant l’interface utilisateur de gestion de configuration ou le workflow basé sur Drush, le bon répertoire est utilisé.

Changements de syntaxe dans Drupal 8.8.0

Dans Drupal 8.8.0, le répertoire de synchronisation est défini dans $settings et non plus dans $config_directories, donc le fichier settings.php doit être mis à jour.

Il suffit de changer de :

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

à :

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