Обзор API конфигурации

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

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

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

API конфигурации поставляется в двух вариантах: (простой) Config API и Configuration Entity API. Ключевое отличие состоит в том, что Config API - это вариант использования с одним экземпляром. Синглтон - это то, где может быть только один экземпляр этой конфигурации. Хорошим примером будет название сайта.

API Entity Configuration должен использоваться для хранения нескольких наборов конфигурации - например, типов узлов, представлений, словарей и полей.

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