Начать транзакцию Connection::startTransaction

Модуль: main — подключать отдельно не нужно

Доступно с версии: 14.0.0

Метод Connection::startTransaction начинает транзакцию. Если транзакция уже открыта, метод создает точку сохранения. Аналог в классическом API — CDatabase::StartTransaction, он вызывает этот метод.

Сигнатура метода в классе Bitrix\Main\DB\Connection:

abstract public function startTransaction();

Возвращаемое значение

Метод ничего не возвращает.

Реализации MySQL и PostgreSQL ведут счетчик уровня вложенности в объекте соединения.

Уровень до вызова Запрос
0 START TRANSACTION
1 и больше SAVEPOINT TRANS<уровень>, например SAVEPOINT TRANS1

После запроса метод увеличивает уровень на единицу. Каждому вызову startTransaction должен соответствовать вызов commitTransaction или rollbackTransaction.

Исключения

Исключение Когда возникает
Bitrix\Main\DB\SqlQueryException База данных вернула ошибку при выполнении запроса
Bitrix\Main\DB\ConnectionException Подключиться к базе данных не удалось

Примеры

Пример. Код добавляет две строки в одной транзакции. Если любая операция выбросит исключение, транзакция откатится. Код вызывает commitTransaction вне блока try, чтобы блок catch не откатил транзакцию, если ошибку вернет сам COMMIT:

<?php
use Bitrix\Main\Application;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$connection = Application::getConnection();

$connection->queryExecute('CREATE TABLE demo_api_status (ID INT NOT NULL, STATUS VARCHAR(20) NOT NULL)');

try
{
    $connection->startTransaction();
    try
    {
        $connection->queryExecute("INSERT INTO demo_api_status (ID, STATUS) VALUES (1, 'new')");
        $connection->queryExecute("INSERT INTO demo_api_status (ID, STATUS) VALUES (2, 'new')");
    }
    catch (\Throwable $exception)
    {
        $connection->rollbackTransaction();
        throw $exception;
    }
    $connection->commitTransaction();

    echo $connection->queryScalar('SELECT COUNT(*) FROM demo_api_status');
}
finally
{
    $connection->dropTable('demo_api_status');
}

Пример. Код выполняет ту же схему через методы CDatabase. Методы StartTransaction, Commit и Rollback вызывают методы соединения D7:

<?php
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

global $DB;

$DB->Query('CREATE TABLE demo_api_status (ID INT NOT NULL, STATUS VARCHAR(20) NOT NULL)');

try
{
    $DB->StartTransaction();
    try
    {
        $DB->Query("INSERT INTO demo_api_status (ID, STATUS) VALUES (1, 'new')");
    }
    catch (\Throwable $exception)
    {
        $DB->Rollback();
        throw $exception;
    }
    $DB->Commit();
}
finally
{
    $DB->Query('DROP TABLE demo_api_status');
}

Смотрите также