<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.yac.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'class.yac.php',
    1 => 'Yac',
    2 => 'Yac 类',
  ),
  'up' => 
  array (
    0 => 'book.yac.php',
    1 => 'Yac',
  ),
  'prev' => 
  array (
    0 => 'yac.constants.php',
    1 => '预定义常量',
  ),
  'next' => 
  array (
    0 => 'yac.add.php',
    1 => 'Yac::add',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/yac/yac.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.yac.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.yac" class="reference">

 <h1 class="title">Yac 类</h1>
 

 <div class="partintro"><p class="verinfo">(PECL yac &gt;= 1.0.0)</p>


  <div class="section" id="yac.intro">
   <h2 class="title">简介</h2>
   <p class="simpara">
    <span class="classname"><strong class="classname">Yac</strong></span> 类是访问缓存的接口。
    同一台主机上的每个实例都是同一个共享缓存的轻量级句柄：
    所有实例读写同一份数据，创建一个实例除了句柄本身之外
    没有任何额外分配。
   </p>
   <p class="simpara">
    传给 <span class="methodname"><a href="yac.construct.php" class="methodname">Yac::__construct()</a></span> 的可选前缀
    会被拼接到每个键的前面，这样多个实例（或多个应用）
    可以共用同一个缓存而键互不冲突。除了常规的缓存操作
    （<span class="methodname"><a href="yac.add.php" class="methodname">Yac::add()</a></span>、
    <span class="methodname"><a href="yac.set.php" class="methodname">Yac::set()</a></span>、
    <span class="methodname"><a href="yac.get.php" class="methodname">Yac::get()</a></span>、
    <span class="methodname"><a href="yac.delete.php" class="methodname">Yac::delete()</a></span> 和
    <span class="methodname"><a href="yac.flush.php" class="methodname">Yac::flush()</a></span>）之外，该类还提供
    <span class="methodname"><a href="yac.info.php" class="methodname">Yac::info()</a></span> 和
    <span class="methodname"><a href="yac.dump.php" class="methodname">Yac::dump()</a></span> 用于检视缓存，
    并且重载了属性访问——读写对象属性就是读写一个缓存条目。
   </p>
  </div>


  <div class="section" id="yac.synopsis">
   <h2 class="title">类摘要</h2>


   <div class="classsynopsis">
    <span class="ooclass"><strong class="classname"></strong></span>


    <div class="classsynopsisinfo">
     <span class="ooclass">
      <span class="modifier">class</span> <strong class="classname">Yac</strong>
     </span>
     {</div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* 属性 */</div>
    <div class="fieldsynopsis">
     <span class="modifier">protected</span>
      <var class="varname"><a href="class.yac.php#yac.props.prefix">$<var class="varname">_prefix</var></a></var>;</div>



    <div class="classsynopsisinfo classsynopsisinfo_comment">/* 方法 */</div>
    <div class="constructorsynopsis dc-description">
   <span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.construct.php" class="methodname">__construct</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$prefix</code><span class="initializer"> = &quot;&quot;</span></span>)</div>

    <div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.add.php" class="methodname">add</a></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.array.php" class="type array">array</a></span></span> <code class="parameter">$key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$value</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$ttl</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.add.php" class="methodname">add</a></span>(<span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$values</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$ttl</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.delete.php" class="methodname">delete</a></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.array.php" class="type array">array</a></span></span> <code class="parameter">$key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$delay</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.dump.php" class="methodname">dump</a></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$limit</code><span class="initializer"> = 100</span></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$offset</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.flush.php" class="methodname">flush</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.get.php" class="methodname">get</a></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.array.php" class="type array">array</a></span></span> <code class="parameter">$key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$default</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.getter.php" class="methodname">__get</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$key</code></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.info.php" class="methodname">info</a></span>(): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.set.php" class="methodname">set</a></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.array.php" class="type array">array</a></span></span> <code class="parameter">$key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$value</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$ttl</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.set.php" class="methodname">set</a></span>(<span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$values</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$ttl</code><span class="initializer"> = 0</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><a href="yac.setter.php" class="methodname">__set</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$value</code></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

   }</div>


  </div>



  <div class="section" id="yac.props">
   <h2 class="title">属性</h2>
   <dl>
    
     <dt id="yac.props.prefix"><var class="varname">_prefix</var></dt>
     <dd>
      <p class="simpara">
       通过 <span class="methodname"><a href="yac.construct.php" class="methodname">Yac::__construct()</a></span> 设置的键前缀。
       它会拼接到该实例使用的每个键的前面；拼接时不会自动插入
       分隔符，需要的话请自己包含在前缀里。前缀长度不能超过
       <strong><code><a href="yac.constants.php#constant.yac-max-key-len">YAC_MAX_KEY_LEN</a></code></strong>（48）字节。
      </p>
     </dd>
    
   </dl>
  </div>



 </div>

 
















































































<h2>目录</h2><ul class="chunklist chunklist_reference"><li><a href="yac.add.php">Yac::add</a> — 存储一个值，但不覆盖已有条目</li><li><a href="yac.construct.php">Yac::__construct</a> — 构造函数</li><li><a href="yac.delete.php">Yac::delete</a> — 从缓存中删除条目</li><li><a href="yac.dump.php">Yac::dump</a> — 导出缓存条目以便检查</li><li><a href="yac.flush.php">Yac::flush</a> — 清空缓存</li><li><a href="yac.get.php">Yac::get</a> — 从缓存中取值</li><li><a href="yac.getter.php">Yac::__get</a> — 以属性语法取值</li><li><a href="yac.info.php">Yac::info</a> — 获取缓存状态</li><li><a href="yac.set.php">Yac::set</a> — 向缓存中存储一个值</li><li><a href="yac.setter.php">Yac::__set</a> — 以属性语法存储一个值</li></ul>
</div>
<?php manual_footer($setup); ?>