diff --git a/sites/default/default.settings.php b/sites/default/default.settings.php index b2ce930..c71894c 100644 --- a/sites/default/default.settings.php +++ b/sites/default/default.settings.php @@ -216,12 +216,21 @@ /** * Location of the site configuration files. * - * By default, Drupal configuration files are stored in a randomly named - * directory under the default public files path. On install the - * named directory is created in the default files directory. For enhanced - * security, you may set this variable to a location outside your docroot. - * - * @todo Flesh this out, provide more details, etc. + * The $config_directories array specifies the location of file system + * directories used to store Drupal's configuration. By default, the active + * configuration is stored in the database and configurations to be imported are + * stored in a staging directory. On install, the staging directory is created + * inside a randomly-named directory in the public files path. + * + * On install, Drupal will also set up an active configuration directory inside + * the same randomly-named directory in the public files path. The active + * directory is expected to be empty unless you change the configuration system + * to use file storage for the active configuration. See the active + * configuration settings documentation below. + * + * If you use files for the active configuration in production you may enhance + * your security by setting the path to the active configuration to a location + * outside your document root. * * Example: * @code @@ -252,7 +261,7 @@ * variable has the same value on each server. * * For enhanced security, you may set this variable to a value using the - * contents of a file outside your docroot that is never saved together + * contents of a file outside your document root that is never saved together * with any backups of your Drupal files and database. * * Example: @@ -605,13 +614,15 @@ * * By default, the active configuration is stored in the database in the * {config} table. To install Drupal with a different active configuration - * storage, you need to override the setting here, in addition to overriding - * the config.storage.active service definition in a module or profile. + * storage, you need to override the 'bootstrap_config_storage' setting here, in + * addition to overriding the config.storage.active service definition in a + * module or profile, or by adding to the container YAML files for DrupalKernel. * * The 'bootstrap_config_storage' setting needs to be a callable that returns - * core.services.yml. + * an instance implementing \Drupal\Core\Config\StorageInterface. */ # $settings['bootstrap_config_storage'] = array('Drupal\Core\Config\BootstrapConfigStorageFactory', 'getFileStorage'); + # $GLOBALS['conf']['container_yamls'][] = $conf_path . '/services.yml'; /** * Configuration overrides.