<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/memcache.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'memcache.ini.php',
    1 => '运行时配置',
    2 => '运行时配置',
  ),
  'up' => 
  array (
    0 => 'memcache.setup.php',
    1 => '安装/配置',
  ),
  'prev' => 
  array (
    0 => 'memcache.installation.php',
    1 => '安装',
  ),
  'next' => 
  array (
    0 => 'memcache.resources.php',
    1 => '资源类型',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/memcache/ini.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="memcache.ini" class="section">
 <h2 class="title">运行时配置</h2>
 <p class="simpara">
这些函数的行为受 <var class="filename">php.ini</var> 中的设置影响。
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Memcache 配置选项</strong></caption>
   
    <thead>
     <tr>
      <th>名字</th>
      <th>默认</th>
      <th>可修改范围</th>
      <th>更新日志</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="memcache.ini.php#ini.memcache.allow-failover" class="link">memcache.allow_failover</a></td>
      <td>&quot;1&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available since memcache 2.0.2.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.max-failover-attempts" class="link">memcache.max_failover_attempts</a></td>
      <td>&quot;20&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available since memcache 2.1.0.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.chunk-size" class="link">memcache.chunk_size</a></td>
      <td>&quot;8192&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available since memcache 2.0.2.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.default-port" class="link">memcache.default_port</a></td>
      <td>&quot;11211&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available since memcache 2.0.2.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.hash-strategy" class="link">memcache.hash_strategy</a></td>
      <td>&quot;standard&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available since memcache 2.2.0.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.hash-function" class="link">memcache.hash_function</a></td>
      <td>&quot;crc32&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Available since memcache 2.2.0.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.protocol" class="link">memcache.protocol</a></td>
      <td>ascii</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Supported since memcache 3.0.0</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.redundancy" class="link">memcache.redundancy</a></td>
      <td>1</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Supported since memcache 3.0.0</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.session-redundancy" class="link">memcache.session_redundancy</a></td>
      <td>2</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Supported since memcache 3.0.0</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.compress-threshold" class="link">memcache.compress_threshold</a></td>
      <td>20000</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Supported since memcache 3.0.3</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.lock-timeout" class="link">memcache.lock_timeout</a></td>
      <td>15</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Supported since memcache 3.0.4</td>
     </tr>

    </tbody>
   
  </table>

  <table class="doctable table">
   <caption><strong>影响 Memcache 行为的 Session 配置选项</strong></caption>
   
    <thead>
     <tr>
      <th>名字</th>
      <th>默认</th>
      <th>可修改范围</th>
      <th>更新日志</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="memcache.ini.php#ini.memcache.save-handler" class="link">session.save_handler</a></td>
      <td>&quot;files&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Supported since memcache 2.1.2</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.php#ini.memcache.save-path" class="link">session.save_path</a></td>
      <td>&quot;&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-all">INI_ALL</a></code></strong></td>
      <td>Supported since memcache 2.1.2</td>
     </tr>

    </tbody>
   
  </table>

  有关 INI_* 样式的更多详情与定义，见 <a href="configuration.changes.modes.php" class="xref">配置可被设定范围</a>。
 </p>

<p class="para">这是配置指令的简短说明。</p>

<dl>

 
  <dt id="ini.memcache.allow-failover">
   <code class="parameter">memcache.allow_failover</code>
   <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>
  </dt>
  <dd>
   <span class="simpara">
    是否在发生错误时（对用户）透明的转移到其他服务器。
   </span>
  </dd>
 

 
  <dt id="ini.memcache.max-failover-attempts">
   <code class="parameter">memcache.max_failover_attempts</code>
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
  </dt>
  <dd>
   <span class="simpara">
   定义在写入和获取数据时最多尝试的服务器次数（即：故障转移最大尝试数），仅和
   memcache.allow_failover 结合使用。
   </span>
  </dd>
 

 
  <dt id="ini.memcache.chunk-size">
   <code class="parameter">memcache.chunk_size</code>
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
  </dt>
  <dd>
   <span class="simpara">
   数据传输块大小，这个值越小网络I/O次数越多，如果发现莫名的速度降低， 可以尝试将此值调至 32768。
   </span>
  </dd>
 

 
  <dt id="ini.memcache.default-port">
   <code class="parameter">memcache.default_port</code>
   <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
  </dt>
  <dd>
   <span class="simpara">
   在连接 memcached 服务器时如果没有指定其它端口则使用默认 TCP 端口号。
   </span>
  </dd>
 

 
  <dt id="ini.memcache.hash-strategy">
   <code class="parameter">memcache.hash_strategy</code>
   <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
  </dt>
  <dd>
   <span class="simpara">
    控制将 key 映射到服务器时使用的（分布式）策略。设置此值为 <code class="literal">consistent</code> 以启用一致散列，允许服务器增减而不会导致重新映射
    key。（译注：参见 http://tech.idv2.com/2008/07/24/memcached-004/）将此值设置为 <code class="literal">standard</code> 会导致使用旧策略。
   </span>
  </dd>
 

 
  <dt id="ini.memcache.hash-function">
   <code class="parameter">memcache.hash_function</code>
   <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
  </dt>
  <dd>
   <span class="simpara">
    控制将 key 映射到服务器时应用哪个 hash 函数，<code class="literal">crc32</code> 使用标准 CRC32 散列，<code class="literal">fnv</code> 使用 FNV-1a。
   </span>
  </dd>
 

 
  <dt id="ini.memcache.protocol">
   <code class="parameter">memcache.protocol</code>
   <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
  </dt>
  <dd>
   <span class="simpara">

   </span>
  </dd>
 

 
  <dt id="ini.memcache.redundancy">
   <code class="parameter">memcache.redundancy</code>
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
  </dt>
  <dd>
   <span class="simpara">

   </span>
  </dd>
 

 
  <dt id="ini.memcache.session-redundancy">
   <code class="parameter">memcache.session_redundancy</code>
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
  </dt>
  <dd>
   <span class="simpara">

   </span>
  </dd>
 

 
  <dt id="ini.memcache.compress-threshold">
   <code class="parameter">memcache.compress_threshold</code>
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
  </dt>
  <dd>
   <span class="simpara">

   </span>
  </dd>
 

 
  <dt id="ini.memcache.lock-timeout">
   <code class="parameter">memcache.lock_timeout</code>
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
  </dt>
  <dd>
   <span class="simpara">

   </span>
  </dd>
 

 
  <dt id="ini.memcache.save-handler">
   <code class="parameter">session.save_handler</code>
   <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
  </dt>
  <dd>
   <span class="simpara">
    通过设置此值为 <code class="literal">memcache</code>，将 memcache 用作 session 处理程序。
   </span>
  </dd>
 

 
  <dt id="ini.memcache.save-path">
   <code class="parameter">session.save_path</code>
   <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
  </dt>
  <dd>
   <span class="simpara">
    定义服务器 URL，以逗号分隔，以用于 session 存储，例如<code class="literal">&quot;tcp://host1:11211, tcp://host2:11211&quot;</code>。
   </span>
   <span class="simpara">
    每个 url 可能包含应用于该服务器的参数，它们与 <span class="function"><a href="memcache.addserver.php" class="function">Memcache::addServer()</a></span> 方法相同。 例如
    <code class="literal">&quot;tcp://host1:11211?persistent=1&amp;weight=1&amp;timeout=1&amp;retry_interval=15&quot;</code>
   </span>
  </dd>
 

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