www.aleph1.co.uk Git - yaffs-website/blob - vendor/drush/drush/docs/config-exporting.md

   1 # Exporting and Importing Configuration
   2
   3 Drush provides commands to export, transfer, and import configuration files
   4 to and from a Drupal 8 site.  Configuration can be altered by different
   5 methods in order to provide different behaviors in different environments;
   6 for example, a development server might be configured slightly differently
   7 than the production server.
   8
   9 This document describes how to make simple value changes to configuration
  10 based on the environment, how to have a different set of enabled modules
  11 in different configurations without affecting your exported configuration
  12 values, and how to make more complex changes.
  13
  14 ## Simple Value Changes
  15
  16 It is not necessary to alter the configuration system values to
  17 make simple value changes to configuration variables, as this may be
  18 done by the [configuration override system](https://www.drupal.org/node/1928898).
  19
  20 The configuration override system allows you to change configuration
  21 values for a given instance of a site (e.g. the development server) by
  22 setting configuration variables in the site's settings.php file.
  23 For example, to change the name of a local development site:
  24 ```
  25 $config['system.site']['name'] = 'Local Install of Awesome Widgets, Inc.';
  26 ```
  27 Note that the configuration override system is a Drupal feature, not
  28 a Drush feature. It should be the preferred method for changing
  29 configuration values on a per-environment basis; however, it does not
  30 work for some things, such as enabling and disabling modules.  For
  31 configuration changes not handled by the configuration override system,
  32 you can use configuration filters of the Config Filter module.
  33
  34 ## Ignoring Development Modules
  35
  36 Use the [Config Split](https://www.drupal.org/project/config_split) module to
  37 split off development configuration in a dedicated config directory.