事务管理（Model Transactions）

当一个进程执行多个数据库操作时，通常需要每一步都是成功完成以便保证数据完整性。事务可以确保在数据提交到数据库保存之前所有数据库操作都成功执行。

Phalcon中通过事务，可以在所有操作都成功执行之后提交到服务器，或者当有错误发生时回滚所有的操作。

自定义事务（Manual Transactions）

如果一个应用只用到了一个数据库连接并且这些事务都不太复杂，那么可以通过简单的将当前数据库连接设置成事务模式实现事务功能，根据操作的成功与否提交或者回滚：

  1. <?php
  3. use Phalcon\Mvc\Controller;
  5. class RobotsController extends Controller
  6. {
  7.     public function saveAction()
  8.     {
  9.         // Start a transaction
  10.         $this->db->begin();
  12.         $robot = new Robots();
  14.         $robot->name       = "WALL·E";
  15.         $robot->created_at = date("Y-m-d");
  17.         // The model failed to save, so rollback the transaction
  18.         if ($robot->save() === false) {
  19.             $this->db->rollback();
  20.             return;
  21.         }
  23.         $robotPart = new RobotParts();
  25.         $robotPart->robots_id = $robot->id;
  26.         $robotPart->type      = "head";
  28.         // The model failed to save, so rollback the transaction
  29.         if ($robotPart->save() === false) {
  30.             $this->db->rollback();
  32.             return;
  33.         }
  35.         // Commit the transaction
  36.         $this->db->commit();
  37.     }
  38. }

隐含的事务（Implicit Transactions）

也可以通过已有的关系来存储记录以及其相关记录，这种操作将隐式地创建一个事务来保证所有数据都能够正确地保存：

  1. <?php
  3. $robotPart = new RobotParts();
  5. $robotPart->type = "head";
  9. $robot = new Robots();
  11. $robot->name       = "WALL·E";
  12. $robot->created_at = date("Y-m-d");
  13. $robot->robotPart  = $robotPart;
  15. // Creates an implicit transaction to store both records
  16. $robot->save();

单独的事务（Isolated Transactions）

单独事务在一个新的连接中执行所有的SQL，虚拟外键检查和业务规则与主数据库连接是相互独立的。 这种事务需要一个事务管理器来全局的管理每一个事务，保证他们在请求结束前能正确的回滚或者提交。

  1. <?php
  3. use Phalcon\Mvc\Model\Transaction\Failed as TxFailed;
  4. use Phalcon\Mvc\Model\Transaction\Manager as TxManager;
  6. try {
  7.     // Create a transaction manager
  8.     $manager = new TxManager();
  10.     // Request a transaction
  11.     $transaction = $manager->get();
  13.     $robot = new Robots();
  15.     $robot->setTransaction($transaction);
  17.     $robot->name       = "WALL·E";
  18.     $robot->created_at = date("Y-m-d");
  20.     if ($robot->save() === false) {
  21.         $transaction->rollback(
  22.             "Cannot save robot"
  23.         );
  24.     }
  26.     $robotPart = new RobotParts();
  28.     $robotPart->setTransaction($transaction);
  30.     $robotPart->robots_id = $robot->id;
  31.     $robotPart->type      = "head";
  33.     if ($robotPart->save() === false) {
  34.         $transaction->rollback(
  35.             "Cannot save robot part"
  36.         );
  37.     }
  39.     // Everything's gone fine, let's commit the transaction
  40.     $transaction->commit();
  41. } catch (TxFailed $e) {
  42.     echo "Failed, reason: ", $e->getMessage();
  43. }

事务可以用以保证以一致性的方式删除多条记录：

  1. <?php
  3. use Phalcon\Mvc\Model\Transaction\Failed as TxFailed;
  4. use Phalcon\Mvc\Model\Transaction\Manager as TxManager;
  6. try {
  7.     // Create a transaction manager
  8.     $manager = new TxManager();
  10.     // Request a transaction
  11.     $transaction = $manager->get();
  13.     // Get the robots to be deleted
  14.     $robots = Robots::find(
  15.         "type = 'mechanical'"
  16.     );
  18.     foreach ($robots as $robot) {
  19.         $robot->setTransaction($transaction);
  21.         // Something's gone wrong, we should rollback the transaction
  22.         if ($robot->delete() === false) {
  23.             $messages = $robot->getMessages();
  25.             foreach ($messages as $message) {
  26.                 $transaction->rollback(
  27.                     $message->getMessage()
  28.                 );
  29.             }
  30.         }
  31.     }
  33.     // Everything's gone fine, let's commit the transaction
  34.     $transaction->commit();
  36.     echo "Robots were deleted successfully!";
  37. } catch (TxFailed $e) {
  38.     echo "Failed, reason: ", $e->getMessage();
  39. }

事务对象可以重用，不管事务对象是在什么地方获取的。只有当一个:code:`commit()`或者一个:code:`rollback()`执行时才会创建一个新的事务对象。可以通过服务容器在整个应用中来创建和管理全局事务管理器。

  1. <?php
  3. use Phalcon\Mvc\Model\Transaction\Manager as TransactionManager
  5. $di->setShared(
  6.     "transactions",
  7.     function () {
  8.         return new TransactionManager();
  9.     }
  10. );

然后在控制器或者视图中访问：

  1. <?php
  3. use Phalcon\Mvc\Controller;
  5. class ProductsController extends Controller
  6. {
  7.     public function saveAction()
  8.     {
  9.         // Obtain the TransactionsManager from the services container
  10.         $manager = $this->di->getTransactions();
  12.         // Or
  13.         $manager = $this->transactions;
  15.         // Request a transaction
  16.         $transaction = $manager->get();
  18.         // ...
  19.     }
  20. }

当一个事务处于活动状态时，在整个应用中事务管理器将总是返回这个相同的事务。