Зафиксировать транзакцию Connection::commitTransaction

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

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

Метод Connection::commitTransaction уменьшает уровень вложенности транзакций на единицу. Метод выполняет запрос COMMIT, только когда уровень становится равен нулю. Аналог в классическом API — CDatabase::Commit, он вызывает этот метод.

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

abstract public function commitTransaction();

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

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

Во вложенной транзакции метод не выполняет запросов. Изменения фиксирует только commitTransaction внешнего уровня. Реализации MySQL и PostgreSQL ведут себя одинаково.

Вызов без начатой транзакции выбрасывает TransactionException и оставляет уровень вложенности отрицательным. Следующий startTransaction на этом соединении выполнит SAVEPOINT вместо START TRANSACTION. Вызывайте commitTransaction только в паре со startTransaction.

Исключения

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

Примеры

Пример. Код вкладывает одну транзакцию в другую. Строку фиксирует только внешний вызов commitTransaction:

<?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->startTransaction();
        try
        {
            $connection->queryExecute("INSERT INTO demo_api_status (ID, STATUS) VALUES (1, 'new')");
        }
        catch (\Throwable $exception)
        {
            $connection->rollbackTransaction();
            throw $exception;
        }
        $connection->commitTransaction();
    }
    catch (\Throwable $exception)
    {
        $connection->rollbackTransaction();
        throw $exception;
    }
    $connection->commitTransaction();

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

Если во внутреннем блоке возникнет ошибка, в MySQL внутренний rollbackTransaction сам выбросит TransactionException. Внешний блок перехватит его и откатит всю транзакцию, но наверх уйдет TransactionException, а не исходное исключение.

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