Drivers section appears to be out of date

Created on 21 May 2024, about 1 month ago

Documentation location/URL

https://www.drupal.org/docs/drupal-apis/database-api/general-concepts#s-... →

Problem/Motivation

Drivers section appears to be out of date.

Starting in drupal:9.4.0 the stated architecture for the core drivers is deprecated. It is removed from drupal:11.0.0. For example The MySQL database driver has been moved to the core mysql module, so that its namespace is now Drupal\mysql\Driver\Database\mysql. See https://www.drupal.org/node/3129492 → .

Proposed resolution

Suggested replacement text:

# Drivers

Because different databases require different sorts of interaction, the Drupal database layer requires a driver for each database type. A driver consists of a series of files located in a module named for one specific database type. For example the core "MySQL" driver is a series of files located in the mysql module, at core/modules/mysql/src/Driver/Database/mysql. Each of the other core database drivers is structured likewise, and located in its own named module, i.e. "pgsql" , and "sqlite". Contrib drivers for other database types may be added to extend core functionality, in their own module's namespace and "src" directory.

## Namespace considerations

Each driver consists of several classes derived from parent classes in the core database system. These driver-specific classes may override whatever behavior is needed to properly support that database type. Driver-specific classes are always namespaced for their database type. For example, the MySQL specific version of Insert is within the Drupal\mysql\Driver\Database\mysql namespace.

Remaining tasks

Review the current documentation.
Update or replace the existing content as appropriate.
Flag this documentation for inclusion in those reviews which are related to release of Drupal 11.

📌 Task
Status

Active

Component

Correction/Clarification

Created by

🇦🇺Australia owenmck

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Production build 0.69.0 2024