额外区块类型 (EBT) - 全新的布局构建器体验❗
滚动
配置 API 概览
03/10/2025, by Ivan
Menu
配置 API 为模块提供了一个集中存储配置数据的位置。该数据可以是简单配置,例如您网站的名称,或者是通过配置对象管理的更复杂的信息,例如视图和内容类型。
配置是存储 您希望从开发环境同步到生产环境的信息 的地方。这些信息通常在网站构建期间创建,通常不会由普通用户在网站正常运行期间生成。
对于不应在不同实例之间移动的本地变量,您应该使用 状态 API,而不是配置。状态用于隐藏的系统值,如果您永远不希望在不同环境之间部署它们。您可以重建系统并丢失所有状态,但配置会被保留。
配置 API 有两种形式:(简单的)Config API 和 Configuration Entity API。关键区别在于 Config API 是单实例用例。单例意味着只能有一个该配置的实例,例如网站名称。
Configuration Entity API 应用于存储多个配置集合,例如节点类型、视图、词汇表和字段。
更新配置 API 对于避免在更新主题和模块以适应 Drupal 8 时出现致命错误至关重要。请参阅 主题更新 和 模块更新信息。