Управление конфигурацией вашего сайта

Drupal хранит данные конфигурации сайта согласованным образом - от списка включенных модулей до типов контента, словарей таксономии, полей и представлений.

Вносить изменения в конфигурацию на действующем сайте не рекомендуется. Система разработана таким образом, чтобы с ее помощью можно было легко использовать текущую конфигурацию, локально тестировать изменения, экспортировать их в файлы и развертывать в рабочей среде. Конфигурация вашего сайта может быть сохранена как часть вашей кодовой базы и интегрирована с контролем версий.

По умолчанию «активная» конфигурация хранится в базе данных (таблица «config»). Это из соображений производительности и безопасности. Это полная конфигурация для всего сайта на данный момент. Конфигурацию можно экспортировать и импортировать как файлы YAML, либо полностью, либо в виде отдельного фрагмента конфигурации, используя команды конфигурации Drush и/или Drupal Console или Configuration Manager. (Подробности смотрите ниже.)

Экспорт и импорт изменений конфигурации между установкой Drupal в различных средах, таких как Разработка, Сценарий и Производство, позволяет вам вносить и проверять изменения на удобном расстоянии от реальной среды вашего сайта.

Это позволяет вам развертывать конфигурацию из одной среды в другую (в качестве меры предосторожности Drupal проверяет, что сайт является тем же самым перед импортом, сравнивая его UUID).

Файлы конфигурации модуля и темы

Конфигурация по умолчанию, поставляемая с модулями, дистрибутивами и темами, импортируется в активное хранилище конфигурации, когда расширения включены. Конфигурация расширения по умолчанию находится в каталоге config/install.

Как импортировать, экспортировать и синхронизировать

С помощью основного модуля Configuration Manager вы можете импортировать, экспортировать и синхронизировать конфигурацию сайта через Управление>Конфигурация>Разработка>Синхронизация конфигурации (admin/config/development/configuration). Вы можете просмотреть изменения перед их импортом.

Либо один объект может быть импортирован или экспортирован с использованием рабочего процесса копирования / вставки. Это полезно, если, например, вы хотите просто переместить созданный вид из одной среды в другую.

Или полную конфигурацию сайта можно также выгрузить в виде файлов YAML в файл tar.gz. Это работает, только если вы перемещаете конфигурацию между двумя копиями одного и того же сайта (например, dev и production) и по этой причине UUID сайтов должны совпадать.

Чтобы проверить UUID сайта из CLI:

- Используя Drush

drush cget system.site

- Используя Drupal Console

drupal debug:config system.site

Примеры полной синхронизации рабочих процессов:

• Использование Drupal UI
• Используя Drush
• Drush config command docs

После завершения синхронизации будут применены все изменения, такие как включение новых модулей, полей или типов контента. Короче говоря, все изменения конфигурации, сделанные на сайте разработки, теперь должны быть в рабочем состоянии.

Дополнительная информация

Если вам нужна более подробная информация о системе управления конфигурацией в Drupal 8, вы можете проверить страницы справочника по API конфигурации.

Нужно и нельзя

НУЖНО:

Настоятельно рекомендуется выполнять database-dump перед каждой синхронизацией промежуточной и активной директорий. Database-dump "может спасти вашу жизнь" при потенциально необходимой стратегии отката.

НЕЛЬЗЯ:

Не пытайтесь изменить активную конфигурацию на вашем сайте, изменяя файлы в каталоге config/install модуля.
Это НЕ будет работать, потому что Drupal будет читать только из этого каталога, когда модуль установлен.
Для редактирования "вживую" вам нужно использовать drush config-edit или drupal config:edit