# 事务

CodeIgniter 允许你在支持事务安全的表上使用事务。在 MySQL 中，你需要将 表的存储引擎设置为 InnoDb 或 BDB，而不是通常我们使用的 MyISAM 。大多数 其他数据库平台都原生支持事务。

如果你对事务还不熟悉，我们推荐针对你正在使用的数据库，先在网上寻找一些 在线资源学习一下。下面将假设你已经明白事务的基本概念。

## CodeIgniter 的事务方法

CodeIgniter 使用的事务处理方法与流行的数据库类 ADODB 的处理方法非常相似。 我们选择这种方式是因为它极大的简化了事务的处理过程。大多数情况下，你只需 编写两行代码就行了。

传统的事务处理需要实现大量的工作，你必须随时跟踪你的查询，并根据查询的成功 或失败来决定提交还是回滚。当遇到嵌套查询时将会更加麻烦。相比之下，我们实现了 一个智能的事务系统，它将自动的为你做这些工作。（你仍然可以选择手工管理你的 事务，但这实在是没啥好处）

## 运行事务

要使用事务来运行你的查询，你可以使用 $this->db->trans_start() 和 $this->db->trans_complete() 两个方法，像下面这样:

    $this->db->trans_start();
    $this->db->query('AN SQL QUERY...');
    $this->db->query('ANOTHER QUERY...');
    $this->db->query('AND YET ANOTHER QUERY...');
    $this->db->trans_complete();

在 start 和 complete 之间，你可以运行任意多个查询，根据查询执行 成功或失败，系统将自动提交或回滚。

## 严格模式 （Strict Mode）

CodeIgniter 默认使用严格模式运行所有的事务，在严格模式下，如果你正在 运行多组事务，只要有一组失败，所有组都会被回滚。如果禁用严格模式，那么 每一组都被视为独立的组，这意味着其中一组失败不会影响其他的组。

严格模式可以用下面的方法禁用:

    $this->db->trans_strict(FALSE);

## 错误处理

如果你的数据库配置文件 config/database.php 中启用了错误报告（db_debug = TRUE）， 当提交没有成功时，你会看到一条标准的错误信息。如果没有启用错误报告， 你可以像下面这样来管理你的错误:

    $this->db->trans_start();
    $this->db->query('AN SQL QUERY...');
    $this->db->query('ANOTHER QUERY...');
    $this->db->trans_complete();

    if ($this->db->trans_status() === FALSE)
    {
        // generate an error... or use the log_message() function to log your error
    }

## 禁用事务

如果你要禁用事务，可以使用 `$this->db->trans_off()` 方法来实现:

    $this->db->trans_off();

    $this->db->trans_start();
    $this->db->query('AN SQL QUERY...');
    $this->db->trans_complete();

当事务被禁用时，你的查询会自动提交，就跟没有使用事务一样， `trans_start()` 和 `trans_complete()` 等方法调用也将被忽略。

## 测试模式（Test Mode）

你可以选择性的将你的事务系统设置为 “测试模式”，这将导致你的所有 查询都被回滚，就算查询成功执行也一样。要使用 “测试模式”，你只需要 将 $this->db->trans_start() 函数的第一个参数设置为 TRUE 即可:

    $this->db->trans_start(TRUE); // Query will be rolled back
    $this->db->query('AN SQL QUERY...');
    $this->db->trans_complete();

## 手工运行事务

如果你想手工运行事务，可以像下面这样做:

    $this->db->trans_begin();

    $this->db->query('AN SQL QUERY...');
    $this->db->query('ANOTHER QUERY...');
    $this->db->query('AND YET ANOTHER QUERY...');

    if ($this->db->trans_status() === FALSE)
    {
        $this->db->trans_rollback();
    }
    else
    {
        $this->db->trans_commit();
    }

注解

手动运行事务时，请务必使用 $this->db->trans_begin() 方法， 而不是 $this->db->trans_start() 方法。