???? Привет! Сегодня мы поговорим о том, как использовать вложенные транзакции в Bitrix, чтобы обеспечить целостность данных.

???? Тайны Транзакций

Версия main 22.200.0 принесла с собой нечто волшебное - вложенные транзакции в Bitrix! Зачем они нужны? Давайте посмотрим на этот процесс с точки зрения магии.

Транзакции - это ваше надежное магическое заклинание, которое гарантирует, что ваши множественные изменения в базе данных будут выполнены целиком или полностью отменены, если что-то пошло не так.

???? Для чего нужны транзакции?

• Транзакции позволяют объединять несколько запросов в единую конструкцию. Она гарантирует, что запросы будут выполнены как единое целое.

• Транзакции - это нечто большее, чем просто блок кода. Это своего рода защитный механизм, который помогает вам избежать проблем с целостностью данных. Они гарантируют, что ваши операции с базой данных будут либо успешными, либо полностью отменены, если что-то пошло не так.

???? Как это было раньше?

Прежде чем волшебство транзакций появилось в Bitrix, разработчики вынуждены были прибегать к тайным приемам.

Создание таблицы-шпиона, где каждое изменение регистрировалось. Это позволяло восстановить предыдущее состояние при ошибке.

Введение транзакций в Bitrix значительно улучшило этот процесс, предоставив более надежные и эффективные способы гарантировать целостность данных.

???? Волшебство в действии: Как это работает в коде?

<?php

$application = \Bitrix\Main\Application::getInstance();
$connection = $application->getConnection();

try {
    $connection->startTransaction();
  
    // Ваш волшебный код здесь...
  
    $connection->commitTransaction();
} catch (\Exception $e) {
    $connection->rollbackTransaction();
}

Окей, давайте рассмотрим пример использования вложенных транзакций на практике. Допустим, у нас есть сущность, назовем ее ExampleTable. Мы хотим изменить поле NAME у записи с кодом 'example'. При этом, мы также хотим добавить новую запись в другую таблицу - AnotherTable.

<?php

$application = \Bitrix\Main\Application::getInstance();
$connection = $application->getConnection(); // Получаем соединение с базой данных

try {
    // Начинаем транзакцию
    $connection->startTransaction();

    // Получаем из сущности некий объект
    $object = \Example\ExampleTable::query()
        ->where('CODE', 'example')
        ->addSelect('NAME')
        ->fetchObject();
		
    if ($object) {
        $object->set('NAME', 'Пример записи'); // Меняем поле `NAME` у объекта
        $result = $object->save(); // Сохраняем
        if (!$result->isSuccess()) {
            throw new \Bitrix\Main\SystemException('Ошибка в процессе сохранения данных.');
        }
            
        // Пробуем добавить второй элемент в другую таблицу
        $anotherObject = \Example\AnotherTable::createObject();
        $anotherObject->set('TITLE', 'New title');
        $result = $anotherObject->save(); // Сохраняем
        if (!$result->isSuccess()) {
            // В случае ошибки откатываем транзакцию, и первый элемент не сохранится
            throw new \Bitrix\Main\SystemException('Ошибка в процессе сохранения данных.');
        }

        // Успешно завершаем транзакцию
        $connection->commitTransaction();
    } else {
        throw new \Bitrix\Main\SystemException('Объект не найден.');
    }
} catch (\Exception $e) {
    // Если произошла ошибка, отменяем транзакцию
    $connection->rollbackTransaction();
}

В этом кусочке кода транзакция начинается, операции выполняются, и если что-то идет не так, мы можем легко и безопасно откатить все изменения.

???? Что делают методы управления транзакциями?

• $connection->startTransaction();: Этот метод начинает транзакцию, позволяя группировать несколько операций в единое целое.

• $connection->commitTransaction();: Вызов этого метода фиксирует все изменения, сделанные в рамках транзакции, и отправляет их в базу данных.

• $connection->rollbackTransaction();: Если произошла ошибка или необходимо отменить все изменения в рамках транзакции, этот метод откатывает все операции.

????️‍????️ Дополнительные тайны:

• Вложенные транзакции применимы не только к save(), но и к другим методам ORM, таким как update(), add(). А также, к SQL запросам через $connection->query()

• Если хотите углубиться в тайны магии транзакций, загляните в официальную документацию Bitrix

???? Завершение:

Таким образом, мы научились использовать волшебство транзакций в Bitrix, обеспечивая целостность данных. Если у вас есть свои волшебные методы или вопросы, делитесь в комментариях!