archived-doc-es/reference/apc/functions/apc-cache-info.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: dc270d6f1898be79414d950bcc5bf64922b721f5 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.apc-cache-info" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>apc_cache_info</refname>
  <refpurpose>
   Recupera información que hay en caché del almacén de datos de APC
  </refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>array</type><methodname>apc_cache_info</methodname>
   <methodparam choice="opt"><type>string</type><parameter>cache_type</parameter><initializer>&quot;&quot;</initializer></methodparam>
   <methodparam choice="opt"><type>bool</type><parameter>limited</parameter><initializer>false</initializer></methodparam>
  </methodsynopsis>
  <para>
   Recupera información que hay en caché y meta-datos del almacén de datos de APC.
  </para>
 </refsect1>
 
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>cache_type</parameter></term>
     <listitem>
      <para>
       Si <parameter>cache_type</parameter> es "<literal>user</literal>",
       será devuelta la información acerca de la caché de usuario.
      </para>
      <para> 
       Si <parameter>cache_type</parameter> es "<literal>filehits</literal>",
       será devuelta la información acerca de qué ficheros han sido servidos desde
       la caché de código de bytes para la solicitud actual. Esta característica debe ser
       habilitada en la compilación usando <option role="configure">--enable-filehits</option>.
      </para>
      <para>
       Si <parameter>cache_type</parameter> no es válido o no se especifica, será devuelta
       la información sobre la caché del sistema (ficheros almacenados en caché).
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>limited</parameter></term>
     <listitem>
      <para>
       Si <parameter>limited</parameter> es &true;, el
       valor devuelto excluirá la lista individual de entradas de caché. Esto es
       útil cuando se intenta optimizar llamadas para reunión de estadísticas.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Un array de datos en caché (y metadatos) &return.falseforfailure;
  </para>
  <note>
   <simpara>
    <function>apc_cache_info</function> emitirá una advertencia si no es capaz de
    recuperar datos en caché de APC. Esto normalmente ocurre cuando APC no está habilitado.
   </simpara>
  </note>
 </refsect1>
 
 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>3.0.11</entry>
       <entry>
        Se introdujo el parámetro <parameter>limited</parameter>.
       </entry>
      </row>
      <row>
       <entry>3.0.16</entry>
       <entry>
        Se introdujo la opción "<literal>filehits</literal>" del
        parámetro <parameter>cache_type</parameter>.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Un ejemplo de <function>apc_cache_info</function></title>
    <programlisting role="php">
<![CDATA[
<?php
print_r(apc_cache_info());
?>
]]>
    </programlisting>
    &example.outputs.similar;
    <screen>
<![CDATA[
Array
(
    [num_slots] => 2000
    [ttl] => 0
    [num_hits] => 9
    [num_misses] => 3
    [start_time] => 1123958803
    [cache_list] => Array
        (
            [0] => Array
                (
                    [filename] => /path/to/apc_test.php
                    [device] => 29954
                    [inode] => 1130511
                    [type] => file
                    [num_hits] => 1
                    [mtime] => 1123960686
                    [creation_time] => 1123960696
                    [deletion_time] => 0
                    [access_time] => 1123962864
                    [ref_count] => 1
                    [mem_size] => 677
                )
            [1] => Array (...itera para cada ficheros en caché)
)
]]>
    </screen>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link linkend="apc.configuration">Directivas de configuración de APC</link></member>
    <member><methodname>APCIterator::getTotalSize</methodname></member>
    <member><methodname>APCIterator::getTotalHits</methodname></member>
    <member><methodname>APCIterator::getTotalCount</methodname></member>
   </simplelist>
  </para>
 </refsect1>
 
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->