function db_transaction | Documentation

1 database.inc db_transaction($name = NULL, array $options = array())

Returns a new transaction object for the active database.

Parameters

string $name: Optional name of the transaction.

array $options: An array of options to control how the transaction operates:

target: The database target name.

Return value

DatabaseTransaction: A new DatabaseTransaction object for this connection.

Related topics

Database abstraction layer Allow the use of different database servers using the same code base.

15 calls to db_transaction()

BackdropTestCase::prepareDatabasePrefix in core/modules/simpletest/backdrop_web_test_case.php: Generates a database prefix for running tests.
DatabaseTransactionTestCase::testTransactionStacking in core/modules/simpletest/tests/database_test.test: Test transaction stacking and commit / rollback.
DatabaseTransactionTestCase::testTransactionWithDdlStatement in core/modules/simpletest/tests/database_test.test: Test the compatibility of transactions with DDL statements.
DatabaseTransactionTestCase::transactionInnerLayer in core/modules/simpletest/tests/database_test.test: Helper method for transaction unit tests. This "inner layer" transaction is either used alone or nested inside of the "outer layer" transaction.
DatabaseTransactionTestCase::transactionOuterLayer in core/modules/simpletest/tests/database_test.test: Helper method for transaction unit test. This "outer layer" transaction starts and then encapsulates the "inner layer" transaction. This nesting is used to evaluate whether the the database transaction API properly supports…

... See full list

File

core/includes/database/database.inc, line 2656: Core systems for the database layer.

Code

function db_transaction($name = NULL, array $options = array()) {
  if (empty($options['target'])) {
    $options['target'] = 'default';
  }
  return Database::getConnection($options['target'])->startTransaction($name);
}