function Database::ignoreTarget

Same name in other branches
  1. 7.x includes/database/database.inc \Database::ignoreTarget()
  2. 9 core/lib/Drupal/Core/Database/Database.php \Drupal\Core\Database\Database::ignoreTarget()
  3. 8.9.x core/lib/Drupal/Core/Database/Database.php \Drupal\Core\Database\Database::ignoreTarget()
  4. 11.x core/lib/Drupal/Core/Database/Database.php \Drupal\Core\Database\Database::ignoreTarget()

Instructs the system to temporarily ignore a given key/target.

At times we need to temporarily disable replica queries. To do so, call this method with the database key and the target to disable. That database key will then always fall back to 'default' for that key, even if it's defined.

Parameters

string $key: The database connection key.

string $target: The target of the specified key to ignore.

2 calls to Database::ignoreTarget()
ConnectionTest::testConnectionRoutingOverride in core/tests/Drupal/KernelTests/Core/Database/ConnectionTest.php
Tests that connections return appropriate connection objects.
ReplicaKillSwitch::checkReplicaServer in core/lib/Drupal/Core/Database/ReplicaKillSwitch.php
Checks and disables the replica database server if appropriate.

File

core/lib/Drupal/Core/Database/Database.php, line 520

Class

Database
Primary front-controller for the database system.

Namespace

Drupal\Core\Database

Code

public static function ignoreTarget($key, $target) {
    self::$ignoreTargets[$key][$target] = TRUE;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.