数据库 API 概览

03/10/2025, by Ivan

Drupal 8 的数据库 API 提供了一个标准的、与供应商无关的抽象层，用于访问数据库服务器。除非您在开发核心 API，否则几乎不应该直接调用数据库。

该 API 的设计目标是尽可能保留 SQL 的语法和功能，同时还要：

数据库 API 的核心文档直接来自代码中的注释。本手册部分补充了这些 API 文档，为希望与数据库系统交互的模块作者提供教程，同时也从管理员的角度提供系统概览。

数据库 API 是基于面向对象的设计概念构建的，因此本文档假定至少部分熟悉这些概念。常见操作也有过程式的风格可用，但不推荐使用这些过程式风格。建议通过数据库连接对象与数据库交互。

请注意，数据库 API 并不总是与数据交互的最佳选择。在 Drupal 8 中，API 的使用通常是具体情境驱动的，例如使用 Node API 进行节点 CRUD 操作，使用 Entity API 创建实体等。请查阅 API 文档以确定哪种 API 最适合您的需求。

注意：本手册可能未涵盖 API 的所有功能。

额外区块类型 (EBT) - 全新的布局构建器体验❗