Drupal 8 configuration management Video of the presentation: http://2014.drupalcampmsk.ru/node/44 (Russian) You can also check my article on this topic: http://amazeelabs.com/node/1093 (English) Alexander Tkachev @ Amazee Labs DrupalConf Moscow 2014

1. http://bit.ly/d8config

2. Drupal 8
configuration management

3. Alexander Tkachev (Leksat)
Drupal developer @ Amazee Labs

4. Overview

5. Background:
types of information
• Content
• Session
• State
• Configuration

6. Background:
types of information
• Content
• Session
• State
• Configuration
• Simple Configuration
• Configuration Entities

7. Where configuration lives
// file: settings.php
$config_directories['active'] =
'sites/default/files/config_XXXX/active';
$config_directories['staging'] =
'sites/default/files/config_XXXX/staging';
Directories are empty by default. Active configuration is stored in
the database for security and speed reasons.
How to move under Git:
simplest way -> remove "/files"
best practice -> outside Drupal root

8. # file: system.site.yml
uuid: c78fd9aa-b327-4514-9d00-bc72a1f40f27
name: 'My cool site'
mail: mailbox@example.com
slogan: 'Drupal 8 rules!'
page:
403: ''
404: ''
front: node
admin_compact_mode: false
weight_select_max: 100
langcode: en

9. A minute of horror
What would be if they chose XML

10. Export/import

16. The same with Drush
$ drush config-export
The current contents of your export directory (sites/default/config_XXXX/staging) will be
deleted. (y/n): y
Configuration successfully exported to sites/default/config_XXXX/staging. [success]
$ drush config-import
Collection Config Operation
system.site update
Import the listed configuration changes? (y/n): y
The configuration was imported successfully. [success]

17. Basic API

18. # file: system.site.yml
uuid: c78fd9aa-b327-4514-9d00-bc72a1f40f27
name: 'My cool site'
mail: mailbox@example.com
slogan: 'Drupal 8 rules!'
page:
403: ''
404: ''
front: node
admin_compact_mode: false
weight_select_max: 100
langcode: en

19. $config = Drupal::config('system.site');
// Instance of DrupalCoreConfigConfig

20. $config = Drupal::config('system.site');
// Instance of DrupalCoreConfigConfig
$front_page = $config->get('page.front');
// 'node'

21. $config = Drupal::config('system.site');
// Instance of DrupalCoreConfigConfig
$front_page = $config->get('page.front');
// 'node'
$page_settings = $config->get('page');
// array(
// '403' => '',
// '404' => '',
// 'front' => 'node',
// )

22. $config = Drupal::config('system.site');
// Instance of DrupalCoreConfigConfig
$front_page = $config->get('page.front');
// 'node'
$page_settings = $config->get('page');
// array(
// '403' => '',
// '404' => '',
// 'front' => 'node',
// )
$config->set('page.front', 'my-front-page');
$config->save();

23. Module/theme defaults
your_module
config
install
your_module.settings.yml

24. Module/theme defaults
your_module
config
install
your_module.settings.yml
views.view.my_cool_view.yml

25. Configuration override levels:
1. settings.php
2. modules:
• overrides are provided by services tagged as
config.factory.override (implementing
ConfigFactoryOverrideInterface)
Get raw (not overridden) data:
1. ConfigFormBase::config() Drupal::config()
2. Config::getRawData()
3. Drupal::configFactory()->setOverrideState(FALSE);

26. React on simple config changes:
• ConfigEvents
(SAVE, DELETE, IMPORT etc.)
• hook_config_import_steps_alter()
(for complicated workflows like fields)

27. Configuration schema
(metadata)

28. # file: core/modules/system/config/install/system.maintenance.yml
message: '@site is currently under maintenance. We should be back shortly. langcode: en

29. # file: core/modules/system/config/install/system.maintenance.yml
message: '@site is currently under maintenance. We should be back shortly. langcode: en
# file: core/modules/system/config/schema/system.schema.yml
system.maintenance:
type: mapping
label: 'Maintenance mode'
mapping:
message:
type: text
label: 'Message to display when in maintenance mode'
langcode:
type: string
label: 'Default language'

30. # file: core/modules/system/config/install/system.maintenance.yml
message: '@site is currently under maintenance. We should be back shortly. langcode: en
# file: core/modules/system/config/schema/system.schema.yml
system.maintenance:
type: mapping
label: 'Maintenance mode'
mapping:
message:
type: text
label: 'Message to display when in maintenance mode'
langcode:
type: string
label: 'Default language'
# file: core/config/schema/core.data_types.schema.yml
text:
type: string
label: 'Text'
translatable: true
# ...
string:
class: 'DrupalCoreTypedDataPluginDataTypeString'
label: 'String'

31. # file: core/modules/system/config/install/system.maintenance.yml
message: '@site is currently under maintenance. We should be back shortly. langcode: en
# file: core/modules/system/config/schema/system.schema.yml
system.maintenance:
type: mapping
label: 'Maintenance mode'
mapping:
message:
type: text
label: 'Message to display when in maintenance mode'
langcode:
type: string
label: 'Default language'
# file: core/config/schema/core.data_types.schema.yml
text:
type: string
label: 'Text'
translatable: true
# ...
string:
class: 'DrupalCoreTypedDataPluginDataTypeString'
label: 'String'

32. # file: core/modules/system/config/install/system.maintenance.yml
message: '@site is currently under maintenance. We should be back shortly. langcode: en
# file: core/modules/system/config/schema/system.schema.yml
system.maintenance:
type: mapping
label: 'Maintenance mode'
mapping:
message:
type: text
label: 'Message to display when in maintenance mode'
langcode:
type: string
label: 'Default language'
# file: core/config/schema/core.data_types.schema.yml
text:
type: string
label: 'Text'
translatable: true
# ...
string:
class: 'DrupalCoreTypedDataPluginDataTypeString'
label: 'String'

33. Modules:
https://www.drupal.org/project/config_tools
https://www.drupal.org/project/config_devel
https://www.drupal.org/project/config_readonly
https://www.drupal.org/project/config_inspector

34. Вопросы?
Leksat@AmazeeLabs*DrupalCampMsk2014
• This presentation
http://bit.ly/d8-configuration
• Configuration API docs
https://www.drupal.org/developing/api/8/configuration
• Drupal core updates
https://groups.drupal.org/core/updates