<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.yac.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'yac.info.php',
    1 => 'Yac::info',
    2 => '获取缓存状态',
  ),
  'up' => 
  array (
    0 => 'class.yac.php',
    1 => 'Yac',
  ),
  'prev' => 
  array (
    0 => 'yac.getter.php',
    1 => 'Yac::__get',
  ),
  'next' => 
  array (
    0 => 'yac.set.php',
    1 => 'Yac::set',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/yac/yac/info.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="yac.info" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Yac::info</h1>
  <p class="verinfo">(PECL yac &gt;= 1.0.0)</p><p class="refpurpose"><span class="refname">Yac::info</span> &mdash; <span class="dc-title">获取缓存状态</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-yac.info-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="modifier">function</span> <span class="methodname"><strong>Yac::info</strong></span>(): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>

  <p class="simpara">
   获取缓存系统的状态。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-yac.info-parameters">
  <h3 class="title">参数</h3>
  <p class="simpara">此函数没有参数。</p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-yac.info-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="simpara">
   返回一个包含以下键的 <span class="type"><a href="language.types.array.php" class="type array">array</a></span>：
  </p>
  <dl>
   
    <dt><code class="literal">memory_size</code></dt>
    <dd><p class="simpara">
     已使用的共享内存总量，单位为字节：槽位表加上值块。
    </p></dd>
   
   
    <dt><code class="literal">slots_memory_size</code></dt>
    <dd><p class="simpara">
     为哈希槽位表预留的内存，单位为字节。
    </p></dd>
   
   
    <dt><code class="literal">values_memory_size</code></dt>
    <dd><p class="simpara">
     为存储的值预留的内存，单位为字节。
    </p></dd>
   
   
    <dt><code class="literal">segment_size</code></dt>
    <dd><p class="simpara">
     单个值内存段的大小，单位为字节。
    </p></dd>
   
   
    <dt><code class="literal">segment_num</code></dt>
    <dd><p class="simpara">
     值内存段的数量。
    </p></dd>
   
   
    <dt><code class="literal">miss</code></dt>
    <dd><p class="simpara">
     缓存未命中次数：查找时没有找到条目或条目已过期。
    </p></dd>
   
   
    <dt><code class="literal">hits</code></dt>
    <dd><p class="simpara">
     缓存命中次数：成功找到条目的查找次数。
    </p></dd>
   
   
    <dt><code class="literal">fails</code></dt>
    <dd><p class="simpara">
     存储失败次数：因无法分配值块而失败的存储次数。
    </p></dd>
   
   
    <dt><code class="literal">kicks</code></dt>
    <dd><p class="simpara">
     驱逐次数：因候选槽位探测路径已满而不得不驱逐已有条目的次数。
    </p></dd>
   
   
    <dt><code class="literal">recycles</code></dt>
    <dd><p class="simpara">
     分配器到达段末尾后回绕到段开头的次数。
    </p></dd>
   
   
    <dt><code class="literal">start_time</code></dt>
    <dd><p class="simpara">
     共享内存缓存初始化时的 Unix 时间戳。
    </p></dd>
   
   
    <dt><code class="literal">slots_size</code></dt>
    <dd><p class="simpara">
     哈希槽位的总数。
    </p></dd>
   
   
    <dt><code class="literal">slots_used</code></dt>
    <dd><p class="simpara">
     当前已被占用的哈希槽位数。
    </p></dd>
   
  </dl>
 </div>


 <div class="refsect1 examples" id="refsect1-yac.info-examples">
  <h3 class="title">示例</h3>
  <div class="example" id="example-1">
   <p><strong>示例 #1 <span class="methodname"><strong>Yac::info()</strong></span> 示例</strong></p>
   <div class="example-contents">
<div class="phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
$yac </span><span style="color: #007700">= new </span><span style="color: #0000BB">Yac</span><span style="color: #007700">();
</span><span style="color: #0000BB">$yac</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">set</span><span style="color: #007700">(</span><span style="color: #DD0000">"foo"</span><span style="color: #007700">, </span><span style="color: #DD0000">"bar"</span><span style="color: #007700">);

</span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$yac</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">info</span><span style="color: #007700">());
</span><span style="color: #0000BB">?&gt;</span></code></pre></div>
   </div>

   <div class="example-contents"><p>以上示例的输出类似于：</p></div>
   <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Array
(
    [memory_size] =&gt; 75497472
    [slots_memory_size] =&gt; 8388608
    [values_memory_size] =&gt; 67108864
    [segment_size] =&gt; 4194304
    [segment_num] =&gt; 16
    [miss] =&gt; 0
    [hits] =&gt; 0
    [fails] =&gt; 0
    [kicks] =&gt; 0
    [recycles] =&gt; 0
    [start_time] =&gt; 1725955200
    [slots_size] =&gt; 65536
    [slots_used] =&gt; 1
)</pre>
</div>
   </div>
   <div class="example-contents"><p>
    命中率可以按 <code class="literal">hits / (hits + miss)</code> 计算；持续增长的 <code class="literal">kicks</code> 或 <code class="literal">fails</code>
    计数器表明缓存正处于内存压力之下。
   </p></div>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-yac.info-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="methodname"><a href="yac.dump.php" class="methodname" rel="rdfs-seeAlso">Yac::dump()</a> - 导出缓存条目以便检查</span></li>
   </ul>
  </p>
 </div>


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