<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.mysqli.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'mysqli.persistconns.php',
    1 => 'mysqli 扩展和持久化连接',
    2 => 'mysqli 扩展和持久化连接',
  ),
  'up' => 
  array (
    0 => 'book.mysqli.php',
    1 => 'MySQLi',
  ),
  'prev' => 
  array (
    0 => 'mysqli.configuration.php',
    1 => '运行时配置',
  ),
  'next' => 
  array (
    0 => 'mysqli.constants.php',
    1 => '预定义常量',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/mysqli/persistconns.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mysqli.persistconns" class="chapter">

 <h1 class="title">mysqli 扩展和持久化连接</h1>

 <p class="para">
  持久化连接的目的在于重用客户端到服务器之间的连接，
  而不是每次在需要的时候都重新建立一个连接。
  由于持久化连接可以将已经建立的连接缓存起来，以备后续的使用，
  所以省去了建立新的连接的开销，
  因此可以带来性能上的提升。
 </p>
 
 <p class="para">
  不像 mysql 扩展，mysqli 没有提供一个特殊的方法用于打开持久化连接。
  需要打开一个持久化连接时，你必须在
  连接时在主机名前增加<code class="literal">p:</code>。
 </p>

 <p class="para">
  使用持久化连接也会存在一些风险，
  因为在缓存中的连接可能处于一种不可预测的状态。
  例如，如果客户端未能正常关闭连接，
  可能在这个连接上残留了对库表的锁，
  那么当这个连接被其他请求重用的时候，这个连接还是处于 <q class="quote">有锁的状态</q>。
  所以，如果要很好的使用持久化连接，那么要求代码在和数据库进行交互的时候，
  确保做好清理工作，保证被缓存的连接是一个干净的，没有残留的状态。
 </p>

 <p class="para">
    <code class="literal">mysqli</code> 扩展的持久化连接提供了内建的清理处理代码。
    <code class="literal">mysqli</code>
    所做的清理工作包括：
 </p>

 <ul class="itemizedlist">

  <li class="listitem">
   <p class="para">
   回滚处于活动状态的事务
   </p>
  </li>

  <li class="listitem">
   <p class="para">
   关闭并且删除临时表
   </p>
  </li>

  <li class="listitem">
   <p class="para">
   对表解锁
   </p>
  </li>

  <li class="listitem">
   <p class="para">
   重置会话变量
   </p>
  </li>

  <li class="listitem">
   <p class="para">
   关闭预编译 SQL 语句（在PHP中经常发生）
   </p>
  </li>

  <li class="listitem">
   <p class="para">
    关闭处理程序
   </p>
  </li>

  <li class="listitem">
   <p class="para">
   释放通过 <span class="function"><strong>GET_LOCK()</strong></span> 获得的锁
   </p>
  </li>

 </ul>

 <p class="para">
    这确保了将连接返回到连接池的时候，
    它处于一种“干净”的状态，可以被其他客户端进程所使用。
 </p>

 <p class="para">
   <code class="literal">mysqli</code> 扩展
   通过自动调用 C-API 函数
   <code class="literal">mysql_change_user()</code> 来完成这个清理工作。
 </p>

 <p class="para">
   自动清理的特性有优点也有缺点。
   优点是程序员不再需要担心附加的清理代码，
   因为它们会自动调用。
   然而缺点就是
   性能 <em>可能会</em> 慢一点，
   因为每次从连接池返回一个连接都需要执行这些清理代码。
 </p>

 <p class="para">
    这个自动清理的代码可以通过在编译 php 时定义
  
    <strong><code>MYSQLI_NO_CHANGE_USER_ON_PCONNECT</code></strong>
  
  
    来关闭。
 </p>

 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="para">
  <code class="literal">mysqli</code> 扩展在使用 
   MySQL Native Driver 或 
   Mysql Client Library（libmysql）时都支持持久化连接。
  </p>
 </p></blockquote>

</div>
<?php manual_footer($setup); ?>