Connection::pushTransaction

public Connection::pushTransaction($name)

Increases the depth of transaction nesting.

If no transaction is already active, we begin a new transaction.

Parameters

string $name: The name of the transaction.

Throws

\Drupal\Core\Database\TransactionNameNonUniqueException

File

core/lib/Drupal/Core/Database/Connection.php, line 1116

Class

Connection: Base Database API class.

Namespace

Drupal\Core\Database

Code

public function pushTransaction($name) {
  if (!$this->supportsTransactions()) {
    return;
  }
  if (isset($this->transactionLayers[$name])) {
    throw new TransactionNameNonUniqueException($name . " is already in use.");
  }
  // If we're already in a transaction then we want to create a savepoint
  // rather than try to create another transaction.
  if ($this->inTransaction()) {
    $this->query('SAVEPOINT ' . $name);
  }
  else {
    $this->connection->beginTransaction();
  }
  $this->transactionLayers[$name] = $name;
}

Links:

https://api.drupal.org/api/drupal/core%21lib%21Drupal%21Core%21Database%21Connection.php/function/Connection%3A%3ApushTransaction/8.2.x

doc_Drupal

2025-01-10 15:47:30

Comments