事务¶

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() 方法。

事务¶