Problem/Motivation

From #3260007: Decouple Connection from the wrapped PDO connection to allow alternative clients.

Let's add an @internal tags to Database API methods that should only be called within DB drivers' code - for instance, ::lastInsertId().

List

Proposed resolution

  • Find all methods that are eligible to an @internal tag
  • Discuss
  • Patch

Remaining tasks

User interface changes

API changes

Data model changes

Release notes snippet

Comments

mondrake created an issue. See original summary.

andypost’s picture

I recall there was issue to review all doc-blocks of db drivers, so this one could be linked there

mondrake’s picture

Note to self: PHPStan has rules around inheritance of @internal classes, let’s make sure we do not break (there’s already an ignored rule in our PHPStan config)

Version: 10.0.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 11.x-dev » main

Drupal core is now using the main branch as the primary development branch. New developments and disruptive changes should now be targeted to the main branch.

Read more in the announcement.