В документации laravel на транзакции не так уж и много сказано. Там есть примеры кода обращений к базе данных в пределах одного замыкания, но что делать, если нам нужно больше свободы? Давайте копнём глубже, что бы посмотреть, что происходит за кадром и какие инструменты мы можем использовать для работы с транзакциями.
\nДанная статья ждала своей очереди на перевод года 4, надеюсь она и сейчас не потеряла своей актуальности. Оставить не переведённой её я не мог.
\nВы возможно уже знаете, что это такое, тем не менее, давайте рассмотрим. Транзакции дают возможность безопасно выполнять набор запросов изменяющие базу данных (например update, insert). Безопасно, потому что вы можете откатить все запросы сделанные в рамках транзакции в любое время их выполнения.
\nПредставим, что у нас есть приложение, которое позволяет регистрировать пользователя и создавать учётные записи. Каждый пользователь может иметь несколько учётных записей связанных с ними.
\nСтоит задача, во время регистрации пользователя обработать \"исключение\" если учётная запись была создана успешно, но пользователь из-за каких-то ошибок не смог создаться.
\nПример кода:
\n // Создание учётной записи\n $newAcct = Account::create([\n 'accountname' => Input::get('accountname'),\n ]);\n \n // Создание пользователя\n $newUser = User::create([\n 'username' => Input::get('username'),\n 'account_id' => $newAcct->id,\n ]);Тут две ситуации которые могут вызвать проблемы:
\nЕсли учетная запись не была создана то и id, необходимое для передачи пользователю для поля account_id мы не получили. В этом случае, учётная запись и пользователь не будет созданы, так что это не обязательно нарушение целостности данных, нам просто нужно обработать эту ситуацию (в коде выше это не показано).
\nЕсли же учётная запись была создана, но создание пользователя не было, то мы сталкиваемся с некоторыми вопросами. Теперь у вас есть учётная запись но к ней не привязаны пользователи, мы имеем нарушение целостности данных в БД. Можно дописать код с различными проверками, удалять в ручную созданные данные, но это же не наш метод! Давайте просто используем транзакции.
\nТранзакции предоставляют нам три \"инструмента\" для работы:
\nПсевдокод, как мог бы выглядеть предыдущий код с транзакциями:
\n // Создание транзакции\n beginTransaction();\n \n // Выполняем запросы\n $acct = createAccount();\n $user = createUser();\n \n // Если какой то из запросов вернул false то делаем откат\n if( !$acct || !$user )\n {\n rollbackTransaction();\n } else {\n // Иначе фиксируем изменения\n commitTransaction();\n }Первый и простой способ выполнить транзакцию в Laravel - это разместить ваши запросы в функции-замыкании метода DB::transaction():
\n DB::transaction(function()\n {\n $newAcct = Account::create([\n 'accountname' => Input::get('accountname')\n ]);\n \n $newUser = User::create([\n 'username' => Input::get('username'),\n 'account_id' => $newAcct->id,\n ]);\n });Одна вещь, которая тут не очевидна - как этот метод знает, что нам нужно откатить или совершить транзакцию?
\nУзнать это можно посмотрев код фреймворка
\n \tpublic function transaction(Closure $callback)\n \t{\n \t\t$this->beginTransaction();\n \t\t// We'll simply execute the given callback within a try / catch block\n \t\t// and if we catch any exception we can rollback the transaction\n \t\t// so that none of the changes are persisted to the database.\n \t\ttry\n \t\t{\n \t\t\t$result = $callback($this);\n \t\t\t$this->commit();\n \t\t}\n \t\t// If we catch an exception, we will roll back so nothing gets messed\n \t\t// up in the database. Then we'll re-throw the exception so it can\n \t\t// be handled how the developer sees fit for their applications.\n \t\tcatch (\\Exception $e)\n \t\t{\n \t\t\t$this->rollBack();\n \t\t\tthrow $e;\n \t\t}\n \t\treturn $result;\n \t}Тут всё работает очень просто, если в функции-замыкании брошено исключение любого рода, то транзакция откатывается назад. Это означает, что любая ошибка SQL выполнит откат транзакций. Так же мы можем и сами вызвать исключение, что приведёт к откату. Что-то вроде этого:
\n DB::transaction(function()\n {\n $newAcct = Account::create([\n 'accountname' => Input::get('accountname')\n ]);\n \n $newUser = User::create([\n 'username' => Input::get('username'),\n 'account_id' => $newAcct->id,\n ]);\n \n if( !$newUser )\n {\n throw new \\Exception('User not created for account');\n }\n });Недавно мне (автору оригинальной статьи) потребовался больший контроль над транзакциями. Create() методы выполняли проверку данных, бросая ValidationException если была проблема с валидностью. И если это исключение было поймано, сервер перенаправлял пользователя на страницу с сообщением об ошибках.
\n try {\n // Валидация и создание, если данные верны\n $newAcct = Account::create( ['accountname' => Input::get('accountname')] );\n } catch(ValidationException $e)\n {\n // Редирект на страницу с ошибкой\n return Redirect::to('/form')\n ->withErrors( $e->getErrors() )\n ->withInput();\n }\n \n try {\n // Валидация и создание, если данные верны\n $newUser = User::create([\n 'username' => Input::get('username'),\n 'account_id' => $newAcct->id\n ]);\n } catch(ValidationException $e)\n {\n // Редирект на страницу с ошибкой\n return Redirect::to('/form')\n ->withErrors( $e->getErrors() )\n ->withInput();\n }Встаёт вопрос, как поместить это в замыкание, если ValidationException всегда ловятся? Размещение этого когда в замыкании DB::transaction() не верно, т.к. гарантированно, что он никогда не вызовет откат, если проверка не завершилась при создании аккаунта или юзера.
\nОднако, более внимательно изучив документацию, мы видим, что можем вручную вызвать beginTransaction, rollback и commit!
\nГлавное, что сделать это очень просто:
\n // Старт транзакции!\n DB::beginTransaction();\n \n try {\n // Валидация и создание, если данные верны\n $newAcct = Account::create( ['accountname' => Input::get('accountname')]);\n } catch(ValidationException $e)\n {\n // Откат и редирект на страницу с ошибкой\n DB::rollback();\n return Redirect::to('/form')\n ->withErrors( $e->getErrors() )\n ->withInput();\n } catch(\\Exception $e)\n {\n // Откат\n DB::rollback();\n throw $e;\n }\n \n try {\n // Валидация и создание, если данные верны\n $newUser = User::create([\n 'username' => Input::get('username'),\n 'account_id' => $newAcct->id\n ]);\n } catch(ValidationException $e)\n {\n // Откат и редирект на страницу с ошибкой\n DB::rollback();\n return Redirect::to('/form')\n ->withErrors( $e->getErrors() )\n ->withInput();\n } catch(\\Exception $e)\n {\n // Откат\n DB::rollback();\n throw $e;\n }\n \n // Если всё хорошо - фиксируем\n DB::commit();Обратите внимание, что на всякий случай ловится и общий Exception (upd: Актуально для версий 5.*), чтобы обеспечить целостность данных, если будет выброшено какое-либо другое исключение, отличное от ValidationException.
\nТо что нужно! Мы полностью контролируем транзакции с базами данных в Laravel!
\nЭта статья - вольный перевод http://fideloper.com/laravel-database-transactions
\nРусская документация по транзакциям http://laravel.su/docs/5.4/database#database-transactions
\nКажется статья несколько устарела и нуждается в обновлении, возникает ряд вопросов почему \"так а не так\", но в целом полезная.
","excerpt":"В документации laravel на транзакции не так уж и много сказано. Там есть примеры кода обращений к базе данных в пределах одного замыкания…"}},"pageContext":{"isCreatedByStatefulCreatePages":false,"type":"posts","next":{"frontmatter":{"path":"/12-polieznykh-mietodov-v-kolliektsiiakh-laravel","title":"12* полезных методов в коллекциях laravel","tags":["Linux","Collections"]},"fileAbsolutePath":"/srv/www/softroot.ru/src/posts/polieznykh-mietodov-v-kolliektsiiakh-laravel.md"},"previous":{"frontmatter":{"path":"/ustanovka-laravel","title":"Установка Laravel","tags":["Linux","Laravel"]},"fileAbsolutePath":"/srv/www/softroot.ru/src/posts/ustanovka-laravel.md"}}}