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

contributors($setup);

?>
<div id="memcached.constants" class="appendix">
 <h1 class="title">预定义常量</h1>

 <p class="simpara">下列常量由此扩展定义，且仅在此扩展编译入 PHP 或在运行时动态载入时可用。</p>
 <dl> 

  
   <dt id="memcached.constants.opt-compression"><strong><code><a href="memcached.constants.php#memcached.constants.opt-compression">Memcached::OPT_COMPRESSION</a></code></strong></dt>
   <dd>
    <p class="para">
    开启或关闭负载压缩。开启后，item 值的长度超过特定阈值（当前是 2000 字节）时，会对值压缩并存储，在检索时会以透明方式解压缩。可以使用
    <a href="memcached.configuration.php#ini.memcached.compression-threshold" class="link">memcached.compression_threshold</a> INI 配置来设置阈值。
    </p>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-compression-type"><strong><code><a href="memcached.constants.php#memcached.constants.opt-compression-type">Memcached::OPT_COMPRESSION_TYPE</a></code></strong></dt>
   <dd>
    <span class="simpara">
     如果启用了压缩，则指定要使用的压缩算法。有效的算法包括
     <strong><code><a href="memcached.constants.php#memcached.constants.compression-fastlz">Memcached::COMPRESSION_FASTLZ</a></code></strong>、<strong><code><a href="memcached.constants.php#memcached.constants.compression-zlib">Memcached::COMPRESSION_ZLIB</a></code></strong> 和
     <strong><code><a href="memcached.constants.php#memcached.constants.compression-zstd">Memcached::COMPRESSION_ZSTD</a></code></strong>。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<strong><code><a href="memcached.constants.php#memcached.constants.compression-fastlz">Memcached::COMPRESSION_FASTLZ</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.compression-fastlz"><strong><code><a href="memcached.constants.php#memcached.constants.compression-fastlz">Memcached::COMPRESSION_FASTLZ</a></code></strong></dt>
   <dd>
    <span class="simpara">
     FASTLZ 压缩算法。
    </span>
   </dd>
  

  
   <dt id="memcached.constants.compression-zlib"><strong><code><a href="memcached.constants.php#memcached.constants.compression-zlib">Memcached::COMPRESSION_ZLIB</a></code></strong></dt>
   <dd>
    <span class="simpara">ZLIB 压缩算法。</span>
   </dd>
  

  
   <dt id="memcached.constants.compression-zstd"><strong><code><a href="memcached.constants.php#memcached.constants.compression-zstd">Memcached::COMPRESSION_ZSTD</a></code></strong></dt>
   <dd>
    <span class="simpara">
     ZSTD 压缩算法。
    </span>
    <span class="simpara">
     自 Memcached 3.3.0 起可用。
    </span>
   </dd>
  

  
   <dt id="memcached.constants.opt-compression-level"><strong><code><a href="memcached.constants.php#memcached.constants.opt-compression-level">Memcached::OPT_COMPRESSION_LEVEL</a></code></strong></dt>
   <dd>
    <span class="simpara">
     如果启用了压缩，则指定要使用的压缩级别。
    </span>
    <ul class="simplelist">
     <li><strong><code><a href="memcached.constants.php#memcached.constants.compression-fastlz">Memcached::COMPRESSION_FASTLZ</a></code></strong> 不支持压缩级别。</li>
     <li><strong><code><a href="memcached.constants.php#memcached.constants.compression-zstd">Memcached::COMPRESSION_ZSTD</a></code></strong>：最低级别为 <code class="literal">-22</code>，最高级别为 <code class="literal">22</code>。</li>
     <li><strong><code><a href="memcached.constants.php#memcached.constants.compression-zlib">Memcached::COMPRESSION_ZLIB</a></code></strong>：最低级别为 <code class="literal">0</code>，最高级别为 <code class="literal">9</code>。</li>
    </ul>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">3</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-serializer"><strong><code><a href="memcached.constants.php#memcached.constants.opt-serializer">Memcached::OPT_SERIALIZER</a></code></strong></dt>
   <dd>
    <span class="simpara">
     指定对于非标量值进行序列化的序列化工具。可用的值有
     <strong><code><a href="memcached.constants.php#memcached.constants.serializer-php">Memcached::SERIALIZER_PHP</a></code></strong>、<strong><code><a href="memcached.constants.php#memcached.constants.serializer-igbinary">Memcached::SERIALIZER_IGBINARY</a></code></strong>、<strong><code><a href="memcached.constants.php#memcached.constants.serializer-json">Memcached::SERIALIZER_JSON</a></code></strong>、<strong><code><a href="memcached.constants.php#memcached.constants.serializer-json-array">Memcached::SERIALIZER_JSON_ARRAY</a></code></strong>
     和 <strong><code><a href="memcached.constants.php#memcached.constants.serializer-msgpack">Memcached::SERIALIZER_MSGPACK</a></code></strong>。
    </span>
    <p class="para">
     类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：优先 <strong><code><a href="memcached.constants.php#memcached.constants.serializer-igbinary">Memcached::SERIALIZER_IGBINARY</a></code></strong>（如果有效），其次
     <strong><code><a href="memcached.constants.php#memcached.constants.serializer-msgpack">Memcached::SERIALIZER_MSGPACK</a></code></strong>（如果有效），最后 <strong><code><a href="memcached.constants.php#memcached.constants.serializer-php">Memcached::SERIALIZER_PHP</a></code></strong>。
    </p>
   </dd>
  

  
   <dt id="memcached.constants.serializer-php"><strong><code><a href="memcached.constants.php#memcached.constants.serializer-php">Memcached::SERIALIZER_PHP</a></code></strong></dt>
   <dd>
    <p class="para">默认的 PHP 序列化工具（即 serialize 方法）。</p>
   </dd>
  

  
   <dt id="memcached.constants.serializer-igbinary"><strong><code><a href="memcached.constants.php#memcached.constants.serializer-igbinary">Memcached::SERIALIZER_IGBINARY</a></code></strong></dt>
   <dd>
    <span class="simpara">
     <a href="book.igbinary.php" class="link">igbinary</a> 序列化工具。它将 php 的数据结构
     存储为紧密的二进制形式，而非文本表示，从而节省时间和空间。
    </span>
    <span class="simpara">
     仅当 memcached 配置了 <strong class="option unknown">--enable-memcached-igbinary</strong> 选项并加载了
     <a href="book.igbinary.php#intro.igbinary" class="link">igbinary</a> 扩展时，才支持此序列化器。
    </span>
   </dd>
  

  
   <dt id="memcached.constants.serializer-json"><strong><code><a href="memcached.constants.php#memcached.constants.serializer-json">Memcached::SERIALIZER_JSON</a></code></strong></dt>
   <dd>
    <p class="para">JSON 序列化器。此序列化器将 JSON 反序列化为对象。</p>
   </dd>
  

  
   <dt id="memcached.constants.serializer-json-array"><strong><code><a href="memcached.constants.php#memcached.constants.serializer-json-array">Memcached::SERIALIZER_JSON_ARRAY</a></code></strong></dt>
   <dd>
    <span class="simpara">
     JSON 数组序列化器。此序列化器将 JSON 反序列化为关联数组
    </span>
   </dd>
  

  
   <dt id="memcached.constants.serializer-msgpack"><strong><code><a href="memcached.constants.php#memcached.constants.serializer-msgpack">Memcached::SERIALIZER_MSGPACK</a></code></strong></dt>
   <dd>
    <span class="simpara">
     <a href="https://pecl.php.net/package/msgpack" class="link external">&raquo;&nbsp;MessagePack</a> 序列化器。
    </span>
    <span class="simpara">
     仅当 memcached 配置了 <strong class="option unknown">--enable-memcached-msgpack</strong> 选项并加载了 <code class="literal">msgpack</code> 扩展时，才支持此序列化器。
    </span>
   </dd>
  

  
   <dt id="memcached.constants.opt-prefix-key"><strong><code><a href="memcached.constants.php#memcached.constants.opt-prefix-key">Memcached::OPT_PREFIX_KEY</a></code></strong></dt>
   <dd>
    <span class="simpara">
     可以用于为 key 创建“域”。这个值将会被作为每个 key 的前缀，它不能长于 <code class="literal">128</code> 个字符，
     并且将会缩短最大可允许的 key 的长度。这个前缀仅仅用于被存储的元素的 key，而不会用于服务器 key。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.string.php" class="type string">string</a></span>，默认：<code class="literal">&quot;&quot;</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-hash"><strong><code><a href="memcached.constants.php#memcached.constants.opt-hash">Memcached::OPT_HASH</a></code></strong></dt>
   <dd>
    <span class="simpara">
     指定存储元素 key 使用的散列算法。可用的值通过 <strong><code><a href="memcached.constants.php#memcached.constants.hash-default">Memcached::HASH_<span class="replaceable">*</span></a></code></strong>
     常量提供。每种散列算法均有其优缺点。若无特定需求或不了解差异，建议使用默认值。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<strong><code><a href="memcached.constants.php#memcached.constants.hash-default">Memcached::HASH_DEFAULT</a></code></strong></p>
   </dd>
  

  
   <dt id="memcached.constants.hash-default"><strong><code><a href="memcached.constants.php#memcached.constants.hash-default">Memcached::HASH_DEFAULT</a></code></strong></dt>
   <dd>
    <p class="para">默认的（Jenkins one-at-a-time）元素 key hash 算法</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-md5"><strong><code><a href="memcached.constants.php#memcached.constants.hash-md5">Memcached::HASH_MD5</a></code></strong></dt>
   <dd>
    <p class="para">md5 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-crc"><strong><code><a href="memcached.constants.php#memcached.constants.hash-crc">Memcached::HASH_CRC</a></code></strong></dt>
   <dd>
    <p class="para">CRC 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-fnv1-64"><strong><code><a href="memcached.constants.php#memcached.constants.hash-fnv1-64">Memcached::HASH_FNV1_64</a></code></strong></dt>
   <dd>
    <p class="para">FNV1_64 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-fnv1a-64"><strong><code><a href="memcached.constants.php#memcached.constants.hash-fnv1a-64">Memcached::HASH_FNV1A_64</a></code></strong></dt>
   <dd>
    <p class="para">FNV1_64A 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-fnv1-32"><strong><code><a href="memcached.constants.php#memcached.constants.hash-fnv1-32">Memcached::HASH_FNV1_32</a></code></strong></dt>
   <dd>
    <p class="para">FNV1_32 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-fnv1a-32"><strong><code><a href="memcached.constants.php#memcached.constants.hash-fnv1a-32">Memcached::HASH_FNV1A_32</a></code></strong></dt>
   <dd>
    <p class="para">FNV1_32A 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-hsieh"><strong><code><a href="memcached.constants.php#memcached.constants.hash-hsieh">Memcached::HASH_HSIEH</a></code></strong></dt>
   <dd>
    <p class="para">Hsieh 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.hash-murmur"><strong><code><a href="memcached.constants.php#memcached.constants.hash-murmur">Memcached::HASH_MURMUR</a></code></strong></dt>
   <dd>
    <p class="para">Murmur 元素 key hash 算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-distribution"><strong><code><a href="memcached.constants.php#memcached.constants.opt-distribution">Memcached::OPT_DISTRIBUTION</a></code></strong></dt>
   <dd>
    <span class="simpara">
     指定元素 key 分布到各个服务器的方法。当前支持的方法有余数分步法合一致性 hash 算法两种。一致性 hash 算法提供
     了更好的分配策略并且在添加服务器到集群时可以最小化缓存丢失。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认:：<strong><code><a href="memcached.constants.php#memcached.constants.distribution-modula">Memcached::DISTRIBUTION_MODULA</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.distribution-modula"><strong><code><a href="memcached.constants.php#memcached.constants.distribution-modula">Memcached::DISTRIBUTION_MODULA</a></code></strong></dt>
   <dd>
    <p class="para">余数分布算法。</p>
   </dd>
  

  
   <dt id="memcached.constants.distribution-consistent"><strong><code><a href="memcached.constants.php#memcached.constants.distribution-consistent">Memcached::DISTRIBUTION_CONSISTENT</a></code></strong></dt>
   <dd>
    <p class="para">一致性分布算法（基于 libketama）。</p>
   </dd>
  

  
   <dt id="memcached.constants.distribution-virtual-bucket"><strong><code><a href="memcached.constants.php#memcached.constants.distribution-virtual-bucket">Memcached::DISTRIBUTION_VIRTUAL_BUCKET</a></code></strong></dt>
   <dd>
    <span class="simpara">
     虚拟桶（bucket）散列 key 分布算法（也称为 vbucket）。
    </span>
   </dd>
  

  
   <dt id="memcached.constants.opt-libketama-compatible"><strong><code><a href="memcached.constants.php#memcached.constants.opt-libketama-compatible">Memcached::OPT_LIBKETAMA_COMPATIBLE</a></code></strong></dt>
   <dd>
    <p class="para">
     开启或关闭兼容的 libketama 类行为。当开启此选项后，元素 key 的 hash 算法将会被设置为 md5 并且分布算法将会
     采用带有权重的一致性 hash 分布。这一点非常有用因为其他基于 libketama 的客户端（比如 Python、Ruby 等）在同样
     的服务端配置下可以透明的访问 key。
    </p>
    <blockquote class="note"><p><strong class="note">注意</strong>: 
     <p class="para">
      如果要使用一致性 hash 算法强烈建议开启此选项，并且这个选项可能在未来的发布版中被设置为默认开启。
     </p>
    </p></blockquote>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-libketama-hash"><strong><code><a href="memcached.constants.php#memcached.constants.opt-libketama-hash">Memcached::OPT_LIBKETAMA_HASH</a></code></strong></dt>
   <dd>
    <span class="simpara">
     指定用于主机映射的散列算法。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-tcp-keepalive"><strong><code><a href="memcached.constants.php#memcached.constants.opt-tcp-keepalive">Memcached::OPT_TCP_KEEPALIVE</a></code></strong></dt>
   <dd>
    <span class="simpara">
     启用 TCP 保活（keep alive）。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认:：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-buffer-writes"><strong><code><a href="memcached.constants.php#memcached.constants.opt-buffer-writes">Memcached::OPT_BUFFER_WRITES</a></code></strong></dt>
   <dd>
    <span class="simpara">
     开启或关闭 I/O 缓存。开启 I/O 缓存会导致存储命令不实际发送而是存储到缓冲区中。任意的检索数据操作都会导致
     缓存中的数据被发送到远程服务端。退出连接或关闭连接也会导致缓存数据被发送到远程服务端。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-binary-protocol"><strong><code><a href="memcached.constants.php#memcached.constants.opt-binary-protocol">Memcached::OPT_BINARY_PROTOCOL</a></code></strong></dt>
   <dd>
    <span class="simpara">
     开启使用二进制协议。请注意这个选项不能在一个打开的连接上进行切换。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-no-block"><strong><code><a href="memcached.constants.php#memcached.constants.opt-no-block">Memcached::OPT_NO_BLOCK</a></code></strong></dt>
   <dd>
    <span class="simpara">
     开启或关闭异步 I/O。这将使得存储函数传输速度最大化。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-noreply"><strong><code><a href="memcached.constants.php#memcached.constants.opt-noreply">Memcached::OPT_NOREPLY</a></code></strong></dt>
   <dd>
    <span class="simpara">
     启用或禁用忽略存储命令（set、add、replace、append、prepend、delete、increment、decrement
     等）的结果。存储命令将直接发送而无需等待响应（也不会返回响应）。检索命令（如
     <span class="methodname"><a href="memcached.get.php" class="methodname">Memcached::get()</a></span>）不受此设置影响。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-tcp-nodelay"><strong><code><a href="memcached.constants.php#memcached.constants.opt-tcp-nodelay">Memcached::OPT_TCP_NODELAY</a></code></strong></dt>
   <dd>
    <p class="para">
     启用或禁用连接套接字的无延迟特性（在某些环境中可能提升速度）。
    </p>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-socket-send-size"><strong><code><a href="memcached.constants.php#memcached.constants.opt-socket-send-size">Memcached::OPT_SOCKET_SEND_SIZE</a></code></strong></dt>
   <dd>
    <span class="simpara">socket 发送缓冲的最大值。</span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：根据不同的平台/内核配置不同</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-socket-recv-size"><strong><code><a href="memcached.constants.php#memcached.constants.opt-socket-recv-size">Memcached::OPT_SOCKET_RECV_SIZE</a></code></strong></dt>
   <dd>
    <span class="simpara">socket 接收缓冲的最大值。</span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：根据不同的平台/内核配置不同</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-connect-timeout"><strong><code><a href="memcached.constants.php#memcached.constants.opt-connect-timeout">Memcached::OPT_CONNECT_TIMEOUT</a></code></strong></dt>
   <dd>
    <span class="simpara">在非阻塞模式下，设置套接字连接期间的超时值，单位是毫秒。</span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">1000</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-retry-timeout"><strong><code><a href="memcached.constants.php#memcached.constants.opt-retry-timeout">Memcached::OPT_RETRY_TIMEOUT</a></code></strong></dt>
   <dd>
    <span class="simpara">
    等待失败的连接重试的时间，单位秒。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">2</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-dead-timeout"><strong><code><a href="memcached.constants.php#memcached.constants.opt-dead-timeout">Memcached::OPT_DEAD_TIMEOUT</a></code></strong></dt>
   <dd>
    <span class="simpara">
     等待重试失效服务器的时间，单位为秒。<code class="literal">0</code> 表示不重试。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">0</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-send-timeout"><strong><code><a href="memcached.constants.php#memcached.constants.opt-send-timeout">Memcached::OPT_SEND_TIMEOUT</a></code></strong></dt>
   <dd>
    <span class="simpara">socket 发送超时时间，单位微秒。在这种情况下您不能使用非阻塞 I/O，这将使得您仍然有数据会发送超时。</span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">0</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-recv-timeout"><strong><code><a href="memcached.constants.php#memcached.constants.opt-recv-timeout">Memcached::OPT_RECV_TIMEOUT</a></code></strong></dt>
   <dd>
    <span class="simpara">socket 读取超时时间，单位微秒。在这种情况下您不能使用非阻塞 I/O，这将使得您仍然有数据会读取超时。</span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">0</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-poll-timeout"><strong><code><a href="memcached.constants.php#memcached.constants.opt-poll-timeout">Memcached::OPT_POLL_TIMEOUT</a></code></strong></dt>
   <dd>
    <span class="simpara">poll 连接超时时间，单位毫秒。</span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">1000</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-cache-lookups"><strong><code><a href="memcached.constants.php#memcached.constants.opt-cache-lookups">Memcached::OPT_CACHE_LOOKUPS</a></code></strong></dt>
   <dd>
    <span class="simpara">开启或禁用 DNS 查找缓存。</span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-server-failure-limit"><strong><code><a href="memcached.constants.php#memcached.constants.opt-server-failure-limit">Memcached::OPT_SERVER_FAILURE_LIMIT</a></code></strong></dt>
   <dd>
    <span class="simpara">指定一个服务器连接的失败重试次数限制。在达到此数量的失败重连后此服务器将被从服务器池中移除。</span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">5</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-server-timeout-limit"><strong><code><a href="memcached.constants.php#memcached.constants.opt-server-timeout-limit">Memcached::OPT_SERVER_TIMEOUT_LIMIT</a></code></strong></dt>
   <dd>
    <span class="simpara">
     指定服务器连接尝试的超时限制。当连续连接超时次数达到此值后，将移除此服务器。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">0</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-auto-eject-hosts"><strong><code><a href="memcached.constants.php#memcached.constants.opt-auto-eject-hosts">Memcached::OPT_AUTO_EJECT_HOSTS</a></code></strong></dt>
   <dd>
    <p class="para">
     从列表中移除已禁用的服务器。需与 <strong><code><a href="memcached.constants.php#memcached.constants.opt-server-failure-limit">Memcached::OPT_SERVER_FAILURE_LIMIT</a></code></strong>
     和 <strong><code><a href="memcached.constants.php#memcached.constants.opt-server-timeout-limit">Memcached::OPT_SERVER_TIMEOUT_LIMIT</a></code></strong> 配合使用。
    </p>
    <blockquote class="note"><p><strong class="note">注意</strong>: 
     <p class="para">
      <strong><code><a href="memcached.constants.php#memcached.constants.opt-remove-failed-servers">Memcached::OPT_REMOVE_FAILED_SERVERS</a></code></strong> 已取代此选项。
     </p>
    </p></blockquote>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-verify-key"><strong><code><a href="memcached.constants.php#memcached.constants.opt-verify-key">Memcached::OPT_VERIFY_KEY</a></code></strong></dt>
   <dd>
    <span class="simpara">
     启用 memcached 对 key 的验证。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-use-udp"><strong><code><a href="memcached.constants.php#memcached.constants.opt-use-udp">Memcached::OPT_USE_UDP</a></code></strong></dt>
   <dd>
    <span class="simpara">
     使用 UDP 而非 TCP。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-number-of-replicas"><strong><code><a href="memcached.constants.php#memcached.constants.opt-number-of-replicas">Memcached::OPT_NUMBER_OF_REPLICAS</a></code></strong></dt>
   <dd>
    <span class="simpara">
     在不同服务器上存储每个元素的指定数量的副本。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，默认：<code class="literal">0</code>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-randomize-replica-reads"><strong><code><a href="memcached.constants.php#memcached.constants.opt-randomize-replica-reads">Memcached::OPT_RANDOMIZE_REPLICA_READS</a></code></strong></dt>
   <dd>
    <span class="simpara">
     对副本读取服务器进行随机化。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.opt-remove-failed-servers"><strong><code><a href="memcached.constants.php#memcached.constants.opt-remove-failed-servers">Memcached::OPT_REMOVE_FAILED_SERVERS</a></code></strong></dt>
   <dd>
    <span class="simpara">
     从列表中移除已禁用的服务器。需与 <strong><code><a href="memcached.constants.php#memcached.constants.opt-server-failure-limit">Memcached::OPT_SERVER_FAILURE_LIMIT</a></code></strong>
     和 <strong><code><a href="memcached.constants.php#memcached.constants.opt-server-timeout-limit">Memcached::OPT_SERVER_TIMEOUT_LIMIT</a></code></strong> 配合使用。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>，默认：<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。</p>
   </dd>
  

  
   <dt id="memcached.constants.have-igbinary"><strong><code><a href="memcached.constants.php#memcached.constants.have-igbinary">Memcached::HAVE_IGBINARY</a></code></strong></dt>
   <dd>
    <span class="simpara">指示是否支持 igbinary 的序列化。</span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>。</p>
   </dd>
  

  
   <dt id="memcached.constants.have-json"><strong><code><a href="memcached.constants.php#memcached.constants.have-json">Memcached::HAVE_JSON</a></code></strong></dt>
   <dd>
    <span class="simpara">指示是否支持 json 的序列化。</span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>。</p>
   </dd>
  

  
   <dt id="memcached.constants.have-msgpack"><strong><code><a href="memcached.constants.php#memcached.constants.have-msgpack">Memcached::HAVE_MSGPACK</a></code></strong></dt>
   <dd>
    <span class="simpara">表示 MessagePack 序列化支持是否有效。</span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>。</p>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.have-zstd"><strong><code><a href="memcached.constants.php#memcached.constants.have-zstd">Memcached::HAVE_ZSTD</a></code></strong></dt>
   <dd>
    <span class="simpara">表示是否支持 ZSTD 压缩。</span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>。</p>
    <p class="para">自 Memcached 3.3.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.have-encoding"><strong><code><a href="memcached.constants.php#memcached.constants.have-encoding">Memcached::HAVE_ENCODING</a></code></strong></dt>
   <dd>
    <span class="simpara">
     表示是否支持使用 <span class="methodname"><a href="memcached.setencodingkey.php" class="methodname">Memcached::setEncodingKey()</a></span> 进行数据加密。
    </span>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>。</p>
    <p class="para">自 Memcached 3.1.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.have-session"><strong><code><a href="memcached.constants.php#memcached.constants.have-session">Memcached::HAVE_SESSION</a></code></strong></dt>
   <dd>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>。</p>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.have-sasl"><strong><code><a href="memcached.constants.php#memcached.constants.have-sasl">Memcached::HAVE_SASL</a></code></strong></dt>
   <dd>
    <p class="para">类型：<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>。</p>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.get-extended"><strong><code><a href="memcached.constants.php#memcached.constants.get-extended">Memcached::GET_EXTENDED</a></code></strong></dt>
   <dd>
    <p class="para">
     <span class="methodname"><a href="memcached.get.php" class="methodname">Memcached::get()</a></span>、<span class="methodname"><a href="memcached.getmulti.php" class="methodname">Memcached::getMulti()</a></span> 和
     <span class="methodname"><a href="memcached.getmultibykey.php" class="methodname">Memcached::getMultiByKey()</a></span> 的 flag，确保返回 CAS 令牌值。
    </p>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.get-preserve-order"><strong><code><a href="memcached.constants.php#memcached.constants.get-preserve-order">Memcached::GET_PRESERVE_ORDER</a></code></strong></dt>
   <dd>
    <p class="para">
     用于 <span class="methodname"><a href="memcached.getmulti.php" class="methodname">Memcached::getMulti()</a></span> 和 <span class="methodname"><a href="memcached.getmultibykey.php" class="methodname">Memcached::getMultiByKey()</a></span>
     的 flag 用以确保返回的 key 和请求的 key 顺序保持一致。不存在的 key 将会得到默认值 <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>。
     </p>
   </dd>
  

  
   <dt id="memcached.constants.res-success"><strong><code><a href="memcached.constants.php#memcached.constants.res-success">Memcached::RES_SUCCESS</a></code></strong></dt>
   <dd>
    <p class="para">操作成功。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-failure">Memcached::RES_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">某种方式的操作失败。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-host-lookup-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-host-lookup-failure">Memcached::RES_HOST_LOOKUP_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">DNS 查找失败。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-unknown-read-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-unknown-read-failure">Memcached::RES_UNKNOWN_READ_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">读取网络数据失败。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-protocol-error"><strong><code><a href="memcached.constants.php#memcached.constants.res-protocol-error">Memcached::RES_PROTOCOL_ERROR</a></code></strong></dt>
   <dd>
    <p class="para">错误的 memcached 协议命令。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-client-error"><strong><code><a href="memcached.constants.php#memcached.constants.res-client-error">Memcached::RES_CLIENT_ERROR</a></code></strong></dt>
   <dd>
    <p class="para">客户端错误。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-server-error"><strong><code><a href="memcached.constants.php#memcached.constants.res-server-error">Memcached::RES_SERVER_ERROR</a></code></strong></dt>
   <dd>
    <p class="para">服务端错误。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-write-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-write-failure">Memcached::RES_WRITE_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">向网络写数据失败。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-data-exists"><strong><code><a href="memcached.constants.php#memcached.constants.res-data-exists">Memcached::RES_DATA_EXISTS</a></code></strong></dt>
   <dd>
    <p class="para">比较并交换值操作失败（cas 方法）：尝试向服务端存储数据时由于自此连接最后一次取此 key 对应数据之后被改变导致失败。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-notstored"><strong><code><a href="memcached.constants.php#memcached.constants.res-notstored">Memcached::RES_NOTSTORED</a></code></strong></dt>
   <dd>
    <p class="para">
     元素未存储，但并非由于错误。这通常表明“add”（元素已存在）或“replace”（元素不存在）命令的条件不满足或者该元素位于删除序列中（延时删除）。
    </p>
   </dd>
  

  
   <dt id="memcached.constants.res-notfound"><strong><code><a href="memcached.constants.php#memcached.constants.res-notfound">Memcached::RES_NOTFOUND</a></code></strong></dt>
   <dd>
    <p class="para">
     元素未找到（通过“get”或“cas”操作时）。
    </p>
   </dd>
  

  
   <dt id="memcached.constants.res-partial-read"><strong><code><a href="memcached.constants.php#memcached.constants.res-partial-read">Memcached::RES_PARTIAL_READ</a></code></strong></dt>
   <dd>
    <p class="para">局部网络数据读错误。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-some-errors"><strong><code><a href="memcached.constants.php#memcached.constants.res-some-errors">Memcached::RES_SOME_ERRORS</a></code></strong></dt>
   <dd>
    <p class="para">在多 key 获取的时候发生错误。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-no-servers"><strong><code><a href="memcached.constants.php#memcached.constants.res-no-servers">Memcached::RES_NO_SERVERS</a></code></strong></dt>
   <dd>
    <p class="para">服务器池空。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-end"><strong><code><a href="memcached.constants.php#memcached.constants.res-end">Memcached::RES_END</a></code></strong></dt>
   <dd>
    <p class="para">结果集到结尾了。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-errno"><strong><code><a href="memcached.constants.php#memcached.constants.res-errno">Memcached::RES_ERRNO</a></code></strong></dt>
   <dd>
    <p class="para">系统错误。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-buffered"><strong><code><a href="memcached.constants.php#memcached.constants.res-buffered">Memcached::RES_BUFFERED</a></code></strong></dt>
   <dd>
    <p class="para">操作被缓存。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-timeout"><strong><code><a href="memcached.constants.php#memcached.constants.res-timeout">Memcached::RES_TIMEOUT</a></code></strong></dt>
   <dd>
    <p class="para">操作超时。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-bad-key-provided"><strong><code><a href="memcached.constants.php#memcached.constants.res-bad-key-provided">Memcached::RES_BAD_KEY_PROVIDED</a></code></strong></dt>
   <dd>
    <p class="para">提供了无效的 key。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-stored"><strong><code><a href="memcached.constants.php#memcached.constants.res-stored">Memcached::RES_STORED</a></code></strong></dt>
   <dd>
    <span class="simpara">元素已存储。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-deleted"><strong><code><a href="memcached.constants.php#memcached.constants.res-deleted">Memcached::RES_DELETED</a></code></strong></dt>
   <dd>
    <span class="simpara">元素已删除。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-stat"><strong><code><a href="memcached.constants.php#memcached.constants.res-stat">Memcached::RES_STAT</a></code></strong></dt>
   <dd>
    <span class="simpara">统计数据。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-item"><strong><code><a href="memcached.constants.php#memcached.constants.res-item">Memcached::RES_ITEM</a></code></strong></dt>
   <dd>
    <span class="simpara">元素。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-not-supported"><strong><code><a href="memcached.constants.php#memcached.constants.res-not-supported">Memcached::RES_NOT_SUPPORTED</a></code></strong></dt>
   <dd>
    <span class="simpara">不支持。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-fetch-notfinished"><strong><code><a href="memcached.constants.php#memcached.constants.res-fetch-notfinished">Memcached::RES_FETCH_NOTFINISHED</a></code></strong></dt>
   <dd>
    <span class="simpara">获取尚未完成。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-server-marked-dead"><strong><code><a href="memcached.constants.php#memcached.constants.res-server-marked-dead">Memcached::RES_SERVER_MARKED_DEAD</a></code></strong></dt>
   <dd>
    <span class="simpara">服务器标记为失效</span>
   </dd>
  

  
   <dt id="memcached.constants.res-unknown-stat-key"><strong><code><a href="memcached.constants.php#memcached.constants.res-unknown-stat-key">Memcached::RES_UNKNOWN_STAT_KEY</a></code></strong></dt>
   <dd>
    <span class="simpara">未知统计 key。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-invalid-host-protocol"><strong><code><a href="memcached.constants.php#memcached.constants.res-invalid-host-protocol">Memcached::RES_INVALID_HOST_PROTOCOL</a></code></strong></dt>
   <dd>
    <span class="simpara">主机协议无效。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-memory-allocation-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-memory-allocation-failure">Memcached::RES_MEMORY_ALLOCATION_FAILURE</a></code></strong></dt>
   <dd>
    <span class="simpara">内存分配失败。</span>
   </dd>
  

  
   <dt id="memcached.constants.res-connection-socket-create-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-connection-socket-create-failure">Memcached::RES_CONNECTION_SOCKET_CREATE_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">创建网络 socket 失败。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-payload-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-payload-failure">Memcached::RES_PAYLOAD_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">不能压缩/解压缩或序列化/反序列化值。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-auth-problem"><strong><code><a href="memcached.constants.php#memcached.constants.res-auth-problem">Memcached::RES_AUTH_PROBLEM</a></code></strong></dt>
   <dd>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-auth-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-auth-failure">Memcached::RES_AUTH_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-auth-continue"><strong><code><a href="memcached.constants.php#memcached.constants.res-auth-continue">Memcached::RES_AUTH_CONTINUE</a></code></strong></dt>
   <dd>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-e2big"><strong><code><a href="memcached.constants.php#memcached.constants.res-e2big">Memcached::RES_E2BIG</a></code></strong></dt>
   <dd>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-key-too-big"><strong><code><a href="memcached.constants.php#memcached.constants.res-key-too-big">Memcached::RES_KEY_TOO_BIG</a></code></strong></dt>
   <dd>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-server-temporarily-disabled"><strong><code><a href="memcached.constants.php#memcached.constants.res-server-temporarily-disabled">Memcached::RES_SERVER_TEMPORARILY_DISABLED</a></code></strong></dt>
   <dd>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

  
   <dt id="memcached.constants.res-server-memory-allocation-failure"><strong><code><a href="memcached.constants.php#memcached.constants.res-server-memory-allocation-failure">Memcached::RES_SERVER_MEMORY_ALLOCATION_FAILURE</a></code></strong></dt>
   <dd>
    <p class="para">自 Memcached 3.0.0 起可用。</p>
   </dd>
  

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