connecting.html 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185
  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/connecting.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>有两种方法连接数据库:</p>
  62. <h2>自动连接</h2>
  63. <p> “自动连接” 功能将在每一个页面加载时被自动实例化数据库类。要启用“自动连接”,可在<kbd>application/config/autoload.php</kbd>中的 library 数组里添加 <var>database</var>:</p>
  64. <code>$autoload['libraries'] = array('database');</code>
  65. <h2>手动连接</h2>
  66. <p>如果仅仅是一部分页面要求数据库连接,你可以在你有需要的函数里手工添加如下代码或者在你的类里手工添加以供该类使用。</p>
  67. <code>$this-&gt;load-&gt;database();</code>
  68. <p class="important">如果以上函数的第一个参数<strong>没有</strong>任何信息,它将会在系统指定的数据库配置文件中寻找,对多数人而言,这是一个首选的方法。</p>
  69. <h3>可用的参数</h3>
  70. <ol>
  71. <li>数据库连接值,用数组或DSN字符串传递。</li>
  72. <li>是否返回连接ID,TRUE/FALSE (boolean),默认值为FALSE (参阅下面的“连接多数据库”)。</li>
  73. <li>是否启用 Active Record 类,TRUE/FALSE (boolean),默认值为 NULL。如有疑问,请查看<kbd>/system/core/Loader.php</kbd>的<var>database()</var>方法</li>
  74. </ol>
  75. <h3>手动连接到一个数据库</h3>
  76. <p>函数的第一个参数能够从你的配置文件中<strong>自由的</strong>指定你自定义的详细的数据库配置信息。或者你甚至可以不通过指定的配置文件来提交数据库的连接属性。
  77. 样例:</p>
  78. <p>要从你的配置文件中选择一个指定的数组你可以这么做:</p>
  79. <code>$this-&gt;load-&gt;database('<samp>group_name</samp>');</code>
  80. <p><samp>group_name</samp>指的是存在于你的配置文件中的带有数据库连接信息的数组的名字。</p>
  81. <p>要手动连接你要求的数据库你可以通过定义以下数组来实现:</p>
  82. <code>$config['hostname'] = "localhost";<br />
  83. $config['username'] = "myusername";<br />
  84. $config['password'] = "mypassword";<br />
  85. $config['database'] = "mydatabase";<br />
  86. $config['dbdriver'] = "mysql";<br />
  87. $config['dbprefix'] = "";<br />
  88. $config['pconnect'] = FALSE;<br />
  89. $config['db_debug'] = TRUE;<br />
  90. $config['cache_on'] = FALSE;<br />
  91. $config['cachedir'] = "";<br />
  92. $config['char_set'] = "utf8";<br />
  93. $config['dbcollat'] = "utf8_general_ci";<br />
  94. <br />
  95. $this-&gt;load-&gt;database(<samp>$config</samp>);</code>
  96. <p>想得到每一个配置属性的详细信息可点击 <a href="configuration.html">这里</a>.</p>
  97. <p>或者你可以以DSN的方式提交数据库配置信息。 DSN必然通过以下方式实现:</p>
  98. <code>$dsn = 'dbdriver://username:password@hostname/database';<br />
  99. <br />
  100. $this-&gt;load-&gt;database(<samp>$dsn</samp>);</code>
  101. <p>当用 DSN 字符串连接时,要覆盖配置默认值,则添加配置变量为查询字符串。</p>
  102. <code>$dsn = 'dbdriver://username:password@hostname/database?char_set=utf8&amp;dbcollat=utf8_general_ci&amp;cache_on=true&amp;cachedir=/path/to/cache';<br />
  103. <br />
  104. $this-&gt;load-&gt;database(<samp>$dsn</samp>);</code>
  105. <p class="important">当你的dbdriver值为<strong>mysqli</strong>来进行远程连接时,切记要指定一个参数<strong>Port</strong>为远程mysql端口</p>
  106. <h2>连接多数据库</h2>
  107. <p>如果你需要同时连接多于一个的数据库,你可以用以下方式来实现:</p>
  108. <code>$DB1 = $this-&gt;load-&gt;database('group_one', TRUE);<br />
  109. $DB2 = $this-&gt;load-&gt;database('group_two', TRUE);
  110. </code>
  111. <p>注意:改变 "group_one" 和 "group_two" 为你指定了连接属性的组名 (或者通过上边说过的连接数组的数组名)。</p>
  112. <p>通过设置函数的第二个参数为TRUE(boolean)来返回一个数据库对象。</p>
  113. <div class="important">
  114. <p>当你使用这种方法,你将用对象名来执行操作命令而不是用户向导模式,也就是说,你将用以下方式执行数据库操作:</p>
  115. <p>$DB1-&gt;query();<br />$DB1-&gt;result();<br /> etc...</p>
  116. <p>而不是:</p>
  117. <p>$this-&gt;db-&gt;query();<br />$this-&gt;db-&gt;result();<br /> etc...</p>
  118. <br /><p>译注:要连接多个数据库请先设置 config/database.php 中的 $db['xxxxxx']['pconnect'] = FALSE; 这是 mysql_pconnect() 造成的问题,和 CI 无关。</p>
  119. </div>
  120. <h2>重新连接 / 保持连接有效</h2>
  121. <p>当你正在进行一些重量级的PHP操作(例如处理图片)时,如果超出了数据库服务器的空闲超时限度,你应该考虑在执行更多查询之前使用<dfn>reconnect()</dfn>方法来向服务器发送ping命令,这样可以优雅地保持或重新建立连接。</p>
  122. <code>$this-&gt;db-&gt;reconnect();</code>
  123. <h2>手动关闭连接</h2>
  124. <p>虽然CodeIgniter 可以智能的管理并自动关闭数据库连接,你仍可以用下面的方法显式的关闭掉。</p>
  125. <code>$this-&gt;db-&gt;close();</code><p>&nbsp;</p>
  126. <div id="Contributors">
  127. 翻译贡献者:
  128. Fanbin, Hex, lishen2, phper08, qixingyue, szlinz, thankwsx, wangjunjie871111, xian366, yinzhili, zehee, zfm1988, 笼中</div>
  129. <div id="DocDate">
  130. 最后修改: 2013-09-08 15:52:16</div>
  131. </div>
  132. <!-- END CONTENT -->
  133. <div id="footer">
  134. <p>
  135. 上一个主题:&nbsp;&nbsp;<a href="configuration.html">数据库配置</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;<a href="#top">页首</a>
  136. &nbsp;&middot;&nbsp;&nbsp;<a href="../index.html">用户指南首页</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;下一个主题:&nbsp;&nbsp;<a href="queries.html">查询</a> </p>
  137. <p><a href="#">CodeIgniter</a> &nbsp;&middot;&nbsp; 版权所有 &#169; 2006-2013 &nbsp;&middot;&nbsp; <a href="#">Ellislab, Inc.</a></p>
  138. <p>中文化: <a href="#">CodeIgniter 中国</a> &nbsp;&middot;&nbsp; 制作: Hex &nbsp;&middot;&nbsp; 版本: 1.30 &nbsp;&middot;&nbsp; 鸣谢: 子非鱼</p>
  139. </div>
  140. </body>
  141. </html>