1.20.x database.inc public DatabaseConnection::pushTransaction($name)

Increases the depth of transaction nesting.

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

Throws

DatabaseTransactionNameNonUniqueException

See also

DatabaseTransaction

File

includes/database/database.inc, line 1184
Core systems for the database layer.

Class

DatabaseConnection
Base Database API class.

Code

public function pushTransaction($name) {
  if (!$this->supportsTransactions()) {
    return;
  }
  if (isset($this->transactionLayers[$name])) {
    throw new DatabaseTransactionNameNonUniqueException($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->pdo->beginTransaction();
  }
  $this->transactionLayers[$name] = $name;
}