function Connection::pushTransaction

Same name and namespace in other branches
  1. 8.9.x core/lib/Drupal/Core/Database/Connection.php \Drupal\Core\Database\Connection::pushTransaction()
  2. 10 core/lib/Drupal/Core/Database/Connection.php \Drupal\Core\Database\Connection::pushTransaction()

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

See also

\Drupal\Core\Database\Transaction

1 call to Connection::pushTransaction()
Connection::addSavepoint in core/modules/pgsql/src/Driver/Database/pgsql/Connection.php
Add a new savepoint with a unique name.

File

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

Class

Connection
Base Database API class.

Namespace

Drupal\Core\Database

Code

public function pushTransaction($name) {
    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;
}

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