事务
最后更新于：2022-04-01 03:55:34
# 事务
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_start() 方法时，事务将自动启用，如果 你要禁用事务，可以使用 $this->db->trans_off() 方法来实现:
~~~
$this->db->trans_off();
$this->db->trans_start();
$this->db->query('AN SQL QUERY...');
$this->db->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() 方法。