public function Connection::rollBack in Drupal 9

Same name in this branch

1. 9 core/lib/Drupal/Core/Database/Connection.php \Drupal\Core\Database\Connection::rollBack()
2. 9 core/lib/Drupal/Core/Database/Driver/mysql/Connection.php \Drupal\Core\Database\Driver\mysql\Connection::rollBack()

Same name and namespace in other branches

1. 8 core/lib/Drupal/Core/Database/Connection.php \Drupal\Core\Database\Connection::rollBack()

Rolls back the transaction entirely or to a named savepoint.

This method throws an exception if no transaction is active.

Parameters

string $savepoint_name: (optional) The name of the savepoint. The default, 'drupal_transaction', will roll the entire transaction back.

Throws

\Drupal\Core\Database\TransactionOutOfOrderException

\Drupal\Core\Database\TransactionNoActiveException

See also

\Drupal\Core\Database\Transaction::rollBack()

2 calls to Connection::rollBack()

Connection::rollBack in core/lib/Drupal/Core/Database/Driver/mysql/Connection.php

Rolls back the transaction entirely or to a named savepoint.

Connection::rollbackSavepoint in core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php

Rollback a savepoint by name if it exists.

1 method overrides Connection::rollBack()

Connection::rollBack in core/lib/Drupal/Core/Database/Driver/mysql/Connection.php

Rolls back the transaction entirely or to a named savepoint.

File

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

Class

Connection

Base Database API class.

Namespace

Drupal\Core\Database

Code

public function rollBack($savepoint_name = 'drupal_transaction') {
  if (!$this
    ->inTransaction()) {
    throw new TransactionNoActiveException();
  }

  // A previous rollback to an earlier savepoint may mean that the savepoint
  // in question has already been accidentally committed.
  if (!isset($this->transactionLayers[$savepoint_name])) {
    throw new TransactionNoActiveException();
  }

  // We need to find the point we're rolling back to, all other savepoints
  // before are no longer needed. If we rolled back other active savepoints,
  // we need to throw an exception.
  $rolled_back_other_active_savepoints = FALSE;
  while ($savepoint = array_pop($this->transactionLayers)) {
    if ($savepoint == $savepoint_name) {

      // If it is the last the transaction in the stack, then it is not a
      // savepoint, it is the transaction itself so we will need to roll back
      // the transaction rather than a savepoint.
      if (empty($this->transactionLayers)) {
        break;
      }
      $this
        ->query('ROLLBACK TO SAVEPOINT ' . $savepoint);
      $this
        ->popCommittableTransactions();
      if ($rolled_back_other_active_savepoints) {
        throw new TransactionOutOfOrderException();
      }
      return;
    }
    else {
      $rolled_back_other_active_savepoints = TRUE;
    }
  }

  // Notify the callbacks about the rollback.
  $callbacks = $this->rootTransactionEndCallbacks;
  $this->rootTransactionEndCallbacks = [];
  foreach ($callbacks as $callback) {
    call_user_func($callback, FALSE);
  }
  $this->connection
    ->rollBack();
  if ($rolled_back_other_active_savepoints) {
    throw new TransactionOutOfOrderException();
  }
}