<?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 => 'fr',
  ),
  'this' => 
  array (
    0 => 'yac.info.php',
    1 => 'Yac::info',
    2 => '&Eacute;tat du cache',
  ),
  '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' => 'fr',
    '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">État du cache</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-yac.info-description">
  <h3 class="title">Description</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">
   Retourne l&#039;état du système de cache.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-yac.info-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <p class="simpara">Cette fonction ne contient aucun paramètre.</p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-yac.info-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="simpara">
   Retourne un <span class="type"><a href="language.types.array.php" class="type array">array</a></span> avec les clés suivantes :
  </p>
  <dl>
   
    <dt><code class="literal">memory_size</code></dt>
    <dd><p class="simpara">
     Mémoire partagée totale utilisée, en octets : la table de slots plus
     les blocs de valeurs.
    </p></dd>
   
   
    <dt><code class="literal">slots_memory_size</code></dt>
    <dd><p class="simpara">
     Mémoire réservée pour la table de hachage de slots, en octets.
    </p></dd>
   
   
    <dt><code class="literal">values_memory_size</code></dt>
    <dd><p class="simpara">
     Mémoire réservée pour les valeurs stockées, en octets.
    </p></dd>
   
   
    <dt><code class="literal">segment_size</code></dt>
    <dd><p class="simpara">
     Taille d&#039;un segment de mémoire de valeurs, en octets.
    </p></dd>
   
   
    <dt><code class="literal">segment_num</code></dt>
    <dd><p class="simpara">
     Nombre de segments de mémoire de valeurs.
    </p></dd>
   
   
    <dt><code class="literal">miss</code></dt>
    <dd><p class="simpara">
     Nombre de défauts de cache : recherches n&#039;ayant rien trouvé ou
     trouvant une entrée expirée.
    </p></dd>
   
   
    <dt><code class="literal">hits</code></dt>
    <dd><p class="simpara">
     Nombre de succès de cache : recherches fructueuses.
    </p></dd>
   
   
    <dt><code class="literal">fails</code></dt>
    <dd><p class="simpara">
     Nombre de stockages échoués : stockages n&#039;ayant pas pu allouer un
     bloc de valeur.
    </p></dd>
   
   
    <dt><code class="literal">kicks</code></dt>
    <dd><p class="simpara">
     Nombre d&#039;évictions : combien de fois une entrée existante a dû être
     expulsée parce que le chemin de slot candidat était plein.
    </p></dd>
   
   
    <dt><code class="literal">recycles</code></dt>
    <dd><p class="simpara">
     Nombre de fois où l&#039;allocateur a atteint la fin d&#039;un segment et est
     revenu à son début.
    </p></dd>
   
   
    <dt><code class="literal">start_time</code></dt>
    <dd><p class="simpara">
     L&#039;horodatage Unix auquel le cache en mémoire partagée a été
     initialisé.
    </p></dd>
   
   
    <dt><code class="literal">slots_size</code></dt>
    <dd><p class="simpara">
     Nombre total de slots de hachage.
    </p></dd>
   
   
    <dt><code class="literal">slots_used</code></dt>
    <dd><p class="simpara">
     Nombre de slots de hachage actuellement occupés.
    </p></dd>
   
  </dl>
 </div>


 <div class="refsect1 examples" id="refsect1-yac.info-examples">
  <h3 class="title">Exemples</h3>
  <div class="example" id="example-1">
   <p><strong>Exemple #1 Exemple avec <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>Résultat de l&#039;exemple ci-dessus est similaire à :</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>
    Le taux de succès peut être calculé comme
    <code class="literal">hits / (hits + miss)</code> ; un compteur
    <code class="literal">kicks</code> ou <code class="literal">fails</code> croissant indique
    que le cache est sous pression mémoire.
   </p></div>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-yac.info-seealso">
  <h3 class="title">Voir aussi</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="methodname"><a href="yac.dump.php" class="methodname" rel="rdfs-seeAlso">Yac::dump()</a> - Vide les entr&eacute;es du cache pour inspection</span></li>
   </ul>
  </p>
 </div>


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