transactions.html 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="utf-8" lang="utf-8">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=0" />
  6. <title>事务 - CodeIgniter 中文手册|用户手册|用户指南|Wiki文档</title>
  7. <link rel="shortcut icon" href="http://codeigniter.org.cn/user_guide/../images/design/favicon.ico" type="image/x-icon" />
  8. <link rel="stylesheet" type="text/css" media="all" href="../userguide.css" />
  9. <link rel="search" href="http://codeigniter.org.cn/user_guide/../CodeIgniterSearch.xml" type="application/opensearchdescription+xml" title="CodeIgniter 搜索"/>
  10. <link rel="canonical" href="http://codeigniter.org.cn/user_guide/database/transactions.html" />
  11. <script type="text/javascript" src="../nav/mootools.js-ver=20130324.js"></script>
  12. <script type="text/javascript" src="../nav/mootools-more.js-ver=20130324.js"></script>
  13. <script type="text/javascript" src="../nav/nav.js-ver=20130324.js"></script>
  14. <script type="text/javascript" src="../nav/user_guide_menu.js-ver=20130324.js"></script>
  15. <meta name="robots" content="all" />
  16. <meta name="author" content="ExpressionEngine Dev Team" />
  17. <meta name="description" content="CodeIgniter 中文手册, CodeIgniter 用户指南, CodeIgniter User Guide, Wiki 文档" />
  18. </head>
  19. <body>
  20. <!-- START NAVIGATION -->
  21. <div id="nav">
  22. <div id="nav_inner">
  23. <script type="text/javascript">create_menu('../');</script>
  24. </div>
  25. </div>
  26. <script type="text/javascript">_setNavigation();</script>
  27. <div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="切换目录" alt="切换目录" /></a></div>
  28. <div id="masthead" class="clearfix">
  29. <div class="topbar-hd"><h1>CodeIgniter 用户指南 版本 2.2.0</h1></div>
  30. <div class="topbar-tip">编辑文档、查看近期更改请 <a href="#">登录</a> 或 <a href="#">注册</a>  <a href="#">找回密码</a></div> <div id="breadcrumb_right"><a href="../toc.html">目录页</a></div>
  31. </div>
  32. <!-- END NAVIGATION -->
  33. <!-- START BREADCRUMB -->
  34. <table cellpadding="0" cellspacing="0" border="0" style="width:100%">
  35. <tr>
  36. <td id="breadcrumb">
  37. <a href="#" target="_blank">CodeIgniter 中国首页</a>&nbsp;&#8250;&nbsp;
  38. <a href="../index.html">用户指南首页</a>&nbsp;&#8250;&nbsp;<a href="index.html">数据库类</a>&nbsp;&#8250;&nbsp;事务 </td>
  39. <td id="searchbox">
  40. <form method="get" action="http://www.google.com.hk/search" target="google_window">
  41. <input type="hidden" name="client" value="pub-0176846097796333"></input>
  42. <input type="hidden" name="forid" value="1"></input>
  43. <input type="hidden" name="ie" value="UTF-8"></input>
  44. <input type="hidden" name="oe" value="UTF-8"></input>
  45. <input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.org.cn/user_guide/" />
  46. 搜索用户指南&nbsp;
  47. <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />
  48. &nbsp;
  49. <input type="submit" class="submit" name="sa" value="Go" />
  50. </form>
  51. </td>
  52. </tr>
  53. </table>
  54. <!-- END BREADCRUMB -->
  55. <div style="clear:both;text-align:right;padding: 6px 40px 0 0;">
  56. <a href="#" target="_blank">查看原文</a>
  57. </div>
  58. <!--<br clear="all" />--><!-- START CONTENT -->
  59. <div id="content">
  60. <h1>事务</h1>
  61. <p>CodeIgniter的数据库抽象允许你在支持事务安全的数据库表中使用<dfn>事务</dfn>。在MySQL中,你需要用InnoDB或BDB表而不是更常用的MyISAM。大多数其它的数据库平台都原生支持事务。</p>
  62. <p>如果你对事务不熟悉,我们建议您上网寻找相关资源学习。以下信息假设你已经明白事务的相关概念。</p>
  63. <h2>CodeIgniter 的事务方法</h2>
  64. <p>CodeIgniter 使用的事务方法与流行的数据库类ADODB所使用的处理过程非常相似。我们选择那种方法是因为它极大地简化了运行事务的处理过程。大多数情况下你只需要编写两行代码就行了。</p>
  65. <p>传统上, 事务需要实现大量工作, 他们要求你随时跟踪你的查询, 并根据查询的成功或失败来决定 <dfn>提交</dfn> 还是 <dfn>回滚</dfn>。这是特别麻烦的嵌套查询。相比之下, 我们实现了一种智能的事务系统, 它将自动地为你做这些事情(如果你选择手动管理你的事务, 这也是可以的, 但这确实没什么好处)。</p>
  66. <h2>运行事务</h2>
  67. <p>要使用事务来运行你的查询, 你可以使用如下所述的 <dfn>$this-&gt;db-&gt;trans_start()</dfn> 和 <dfn>$this-&gt;db-&gt;trans_complete()</dfn> 函数:</p>
  68. <code>
  69. <kbd>$this-&gt;db-&gt;trans_start();</kbd><br />
  70. $this-&gt;db-&gt;query('一条SQL查询...');<br />
  71. $this-&gt;db-&gt;query('另一条查询...');<br />
  72. $this-&gt;db-&gt;query('还有一条查询...');<br />
  73. <kbd>$this-&gt;db-&gt;trans_complete();</kbd>
  74. </code>
  75. <p>在 start/complete 函数之间, 你想运行多少条查询都可以, 根据任何给定查询的成功或失败, 它们将被提交或者回滚。</p>
  76. <h2>严格模式(Strict Mode)</h2>
  77. <p>默认情况下, CodeIgniter 以<dfn>严格模式</dfn>运行所有事务。当严格模式被启用时, 如果你正在运行多组的事务, 只要有一组失败, 所有组都会被回滚。如果严格模式被禁用, 每一组都被视为独立的组, 这意味着其中一个组的失败不会影响其它组。</p>
  78. <p>严格模式能以下面的方式禁用:</p>
  79. <code>$this-&gt;db-&gt;trans_strict(FALSE);</code>
  80. <h2>管理错误信息</h2>
  81. <p>如果你在你的 <dfn>config/database.php</dfn> 文件中启用了错误报告, 当提交没有成功时, 你会看到一条标准的错误信息。如果调试被关闭, 你可以通过这种方式来管理你的错误信息:</p>
  82. <code>
  83. $this-&gt;db-&gt;trans_start();<br />
  84. $this-&gt;db-&gt;query('AN SQL QUERY...');<br />
  85. $this-&gt;db-&gt;query('ANOTHER QUERY...');<br />
  86. $this-&gt;db-&gt;trans_complete();<br />
  87. <br />
  88. if (<kbd>$this-&gt;db-&gt;trans_status()</kbd> === FALSE)<br />
  89. &#123;<br />
  90. &nbsp;&nbsp;&nbsp;&nbsp;// 生成一条错误信息... 或者使用 log_message() 函数来记录你的错误信息<br />
  91. &#125;
  92. </code>
  93. <h2>禁用事务</h2>
  94. <p>当你使用 <dfn>$this-&gt;db-&gt;trans_start()</dfn> 时, 事务就已经被自动启用了。如果你想要禁用事务, 你可以使用 <dfn>$this-&gt;db-&gt;trans_off()</dfn> 来实现:</p>
  95. <code>
  96. <kbd>$this-&gt;db-&gt;trans_off()</kbd><br /><br />
  97. $this-&gt;db-&gt;trans_start();<br />
  98. $this-&gt;db-&gt;query('AN SQL QUERY...');<br />
  99. $this-&gt;db-&gt;trans_complete();
  100. </code>
  101. <p class="important">当事务被禁用的时候, 你的查询将被自动提交, 就像没有使用事务时那样。</p>
  102. <h2>测试模式(Test Mode)</h2>
  103. <p>你可以选择性地将事务系统设置到 "测试模式" , 这将导致你的查询被回滚 -- 尽管查询会生成有效结果。要使用测试模式, 只需将 <dfn>$this-&gt;db-&gt;trans_start()</dfn> 函数的第一个参数设置为 <samp>TRUE</samp> 即可:</p>
  104. <code>
  105. $this-&gt;db-&gt;trans_start(<samp>TRUE</samp>); // 查询将被回滚<br />
  106. $this-&gt;db-&gt;query('AN SQL QUERY...');<br />
  107. $this-&gt;db-&gt;trans_complete();
  108. </code>
  109. <h2>手动运行事务</h2>
  110. <p>如果你想要手动运行事务, 可以使用下面的方法:</p>
  111. <code>
  112. $this-&gt;db-&gt;trans_begin();<br /><br />
  113. $this-&gt;db-&gt;query('AN SQL QUERY...');<br />
  114. $this-&gt;db-&gt;query('ANOTHER QUERY...');<br />
  115. $this-&gt;db-&gt;query('AND YET ANOTHER QUERY...');<br />
  116. <br />
  117. if ($this-&gt;db-&gt;trans_status() === FALSE)<br />
  118. &#123;<br />
  119. &nbsp;&nbsp;&nbsp;&nbsp;$this-&gt;db-&gt;trans_rollback();<br />
  120. &#125;<br />
  121. else<br />
  122. &#123;<br />
  123. &nbsp;&nbsp;&nbsp;&nbsp;$this-&gt;db-&gt;trans_commit();<br />
  124. &#125;<br />
  125. </code>
  126. <p class="important"><strong>说明:</strong> 手动运行事务时, 请务必使用 <kbd>$this-&gt;db-&gt;trans_begin()</kbd> 函数, 而<strong>不是</strong>
  127. <dfn>$this-&gt;db-&gt;trans_start()</dfn>.</p><p>&nbsp;</p>
  128. <div id="Contributors">
  129. 翻译贡献者:
  130. Drice, Hex, iptton, yinzhili</div>
  131. <div id="DocDate">
  132. 最后修改: 2010-10-22 11:07:30</div>
  133. </div>
  134. <!-- END CONTENT -->
  135. <div id="footer">
  136. <p>
  137. 上一个主题:&nbsp;&nbsp;<a href="fields.html">字段元数据</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;<a href="#top">页首</a>
  138. &nbsp;&middot;&nbsp;&nbsp;<a href="../index.html">用户指南首页</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;下一个主题:&nbsp;&nbsp;<a href="table_data.html">数据库表元数据</a> </p>
  139. <p><a href="#">CodeIgniter</a> &nbsp;&middot;&nbsp; 版权所有 &#169; 2006-2013 &nbsp;&middot;&nbsp; <a href="#">Ellislab, Inc.</a></p>
  140. <p>中文化: <a href="#">CodeIgniter 中国</a> &nbsp;&middot;&nbsp; 制作: Hex &nbsp;&middot;&nbsp; 版本: 1.30 &nbsp;&middot;&nbsp; 鸣谢: 子非鱼</p>
  141. </div>
  142. </body>
  143. </html>