ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<section xml:id="wincache.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  La siguiente tabla enumera y explica los ajustes de configuración
  proporcionados por la extensión WinCache:
 </para>
 <para>
  <table>
   <title>Opciones de configuración de WinCache</title>
   <tgroup cols="6">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>Mínimo</entry>
      <entry>Máximo</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><link linkend="ini.wincache.fcenabled">wincache.fcenabled</link></entry>
      <entry>"1"</entry>
      <entry>"0"</entry>
      <entry>"1"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.fcenabledfilter">wincache.fcenabledfilter</link></entry>
      <entry>"NULL"</entry>
      <entry>"NULL"</entry>
      <entry>"NULL"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.fcachesize">wincache.fcachesize</link></entry>
      <entry>"24"</entry>
      <entry>"5"</entry>
      <entry>"255"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.fcndetect">wincache.fcndetect</link></entry>
      <entry>"1"</entry>
      <entry>"0"</entry>
      <entry>"1"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.1.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.maxfilesize">wincache.maxfilesize</link></entry>
      <entry>"256"</entry>
      <entry>"10"</entry>
      <entry>"2048"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.ocenabled">wincache.ocenabled</link></entry>
      <entry>"1"</entry>
      <entry>"0"</entry>
      <entry>"1"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0. Eliminada a partir de 2.0.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.ocenabledfilter">wincache.ocenabledfilter</link></entry>
      <entry>"NULL"</entry>
      <entry>"NULL"</entry>
      <entry>"NULL"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0. Eliminada a partir de 2.0.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.ocachesize">wincache.ocachesize</link></entry>
      <entry>"96"</entry>
      <entry>"15"</entry>
      <entry>"255"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0. Eliminada a partir de 2.0.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.filecount">wincache.filecount</link></entry>
      <entry>"4096"</entry>
      <entry>"1024"</entry>
      <entry>"16384"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.chkinterval">wincache.chkinterval</link></entry>
      <entry>"30"</entry>
      <entry>"0"</entry>
      <entry>"300"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.ttlmax">wincache.ttlmax</link></entry>
      <entry>"1200"</entry>
      <entry>"0"</entry>
      <entry>"7200"</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.enablecli">wincache.enablecli</link></entry>
      <entry>0</entry>
      <entry>0</entry>
      <entry>1</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.ignorelist">wincache.ignorelist</link></entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.namesalt">wincache.namesalt</link></entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.ucenabled">wincache.ucenabled</link></entry>
      <entry>1</entry>
      <entry>0</entry>
      <entry>1</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.1.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.ucachesize">wincache.ucachesize</link></entry>
      <entry>8</entry>
      <entry>5</entry>
      <entry>85</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.1.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.scachesize">wincache.scachesize</link></entry>
      <entry>8</entry>
      <entry>5</entry>
      <entry>85</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.1.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.rerouteini">wincache.rerouteini</link></entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.2.0. Eliminada a partir de 1.3.7</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.reroute_enabled">wincache.reroute_enabled</link></entry>
      <entry>1</entry>
      <entry>0</entry>
      <entry>1</entry>
      <entry><constant>INI_SYSTEM</constant>|<constant>INI_PERDIR</constant></entry>
      <entry>Disponible a partir de WinCache 1.3.7</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.srwlocks">wincache.srwlocks</link></entry>
      <entry>1</entry>
      <entry>0</entry>
      <entry>1</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.3.6.3. Eliminada a partir de 2.0.0.0</entry>
     </row>
     <row>
      <entry><link linkend="ini.wincache.filemapdir">wincache.filemapdir</link></entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry>NULL</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry>Disponible a partir de WinCache 1.3.7.4</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.wincache.fcenabled">
    <term>
     <parameter>wincache.fcenabled</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <simpara>Habilita o deshabilita la caché de ficheros.</simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.fcenabledfilter">
    <term>
     <parameter>wincache.fcenabledfilter</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      Define una lista separada por comas de identificadores de sitios web de IIS donde debería
      habilitarse o deshabilitarse la caché de ficheros. Esta opción funciona junto
      con <literal>wincache.fcenabled</literal>: si <literal>wincache.fcenabled</literal>
      se establece a 1, los sitios enumerados en <literal>wincache.fcenabledfilter</literal>
      tendrán la caché de ficheros desactivada; si <literal>wincache.fcenabled</literal>
      se establece a 0, los sitios enumerados en <literal>wincache.fcenabledfilter</literal>
      tendrán la caché activada.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.fcachesize">
    <term>
     <parameter>wincache.fcachesize</parameter>
     <type>int</type>
    </term>
    <listitem>
     <simpara>
      Define el tamaño máximo de memoria (en megabytes) que se asigna a la caché de ficheros.
      Si el tamaño total de ficheros en caché excede el valor especificado en este ajuste,
      se eliminarán los ficheros más antiguos de la caché de ficheros.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.fcndetect">
    <term>
     <parameter>wincache.fcndetect</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <simpara>
      Habilita o deshabilita la detección de notificaciones de cambios en ficheros. Si está soportada
      la notificación de cambios en ficheros, se usará para refrescar las entradas de la caché de códigos de operación y de ficheros
      en cuanto los ficheros correspondientes sean modificados en un sistema de ficheros. Si la notificación de cambios en ficheros
      no está soportada, por ejemplo, al usar la compartición de ficheros en red, wincache hará un sondeo para
      los cambios en ficheros en intervalos de tiempo regulares especificados por <literal>wincache.chkinterval</literal>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.maxfilesize">
    <term>
     <parameter>wincache.maxfilesize</parameter>
     <type>int</type>
    </term>
    <listitem>
     <simpara>
      Define el tamaño máximo permitido (en kilobytes) para que un fichero sea almacenado en caché.
      Si un fichero excede el valor especificado, no será almacenado en caché.
      Este ajuste se aplica solamente a la caché de ficheros.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.ocenabled">
    <term>
     <parameter>wincache.ocenabled</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opción ha sido <emphasis>eliminada</emphasis> a partir de 2.0.0.0</simpara></warning>
     <simpara>Habilita o deshabilita la caché de códigos de operaciones ("opcodes")</simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.ocenabledfilter">
    <term>
     <parameter>wincache.ocenabledfilter</parameter>
     <type>string</type>
    </term>
    <listitem>
     <warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opción ha sido <emphasis>eliminada</emphasis> a partir de 2.0.0.0</simpara></warning>
     <simpara>
      Define una lista separada por comas de identificadores de sitios web de IIS donde se debería
      habilitar o deshabilitar la caché de códigos de operaciones. Este ajuste funciona junto con
      <literal>wincache.ocenabled</literal>: si <literal>wincache.ocenabled</literal>
      se establece a 1, los sitios enumerados en <literal>wincache.ocenabledfilter</literal>
      tendrán la caché de códigos de operaciones desactivada; si <literal>wincache.ocenabled</literal>
      se establece a 0, los sitios enumerados en <literal>wincache.ocenabledfilter</literal>
      tendrán la caché de códigos de operaciones activada.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.ocachesize">
    <term>
     <parameter>wincache.ocachesize</parameter>
     <type>int</type>
    </term>
    <listitem>
     <warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opción ha sido <emphasis>eliminada</emphasis> a partir de 2.0.0.0</simpara></warning>
     <simpara>
      Define el tamaño máximo de memoria (en megabytes) que se asigna a la caché de
      códigos de operaciones. Si el tamaño de dicha caché excede el valor especificado
      se eliminarán de la caché los códigos de operación más antiguos. Observe que el tamaño
      de la caché de códigos de operaciones debe ser al menos tres veces mayor que el tamaño de la caché de ficheros.
      Si no fuera así, el tamaño de la caché de códigos de operaciones será aumentada automáticamente.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.filecount">
    <term>
     <parameter>wincache.filecount</parameter>
     <type>int</type>
    </term>
    <listitem>
     <simpara>
      Define cuántos ficheros se preveen que almacene en caché la extensión, para así asignar el
      tamaño de memoria apropiada en el momento del arranque. Si el número de ficheros excede el valor
      especificado, WinCache reasignará tanta memoria como sea necesaria.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.chkinterval">
    <term>
     <parameter>wincache.chkinterval</parameter>
     <type>int</type>
    </term>
    <listitem>
     <simpara>
      Define la frecuencia (en segundos) con que la extensión comprobará los cambios en ficheros
      para refrescar la caché. Si se establece a 0 se deshabilitará el refresco de la caché.
      Los cambios en ficheros no se verán reflejados en la caché al menos que la entrada de la caché
      para tales ficheros sea eliminada mediante limpieza ("scavenger"), o la provisión ("pool") de aplicaciones
      de IIS sea reclicada, o se llame a la función wincache_refresh_if_changed.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.ttlmax">
    <term>
     <parameter>wincache.ttlmax</parameter>
     <type>int</type>
    </term>
    <listitem>
     <simpara>
      Define el tiempo máximo de vida (en segundos) para una entrada de caché que no se esté usando.
      Si se establece a 0, se desactivará la limpieza de la caché, por lo que las entradas en caché nunca
      serán eliminadas durante el tiempo de vida del proceso obrero ("worker") de IIS.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.enablecli">
    <term>
     <parameter>wincache.enablecli</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <simpara>
      Define si la caché se habilita cuando PHP se está ejecutando en modo de línea de comandos (CLI).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.ignorelist">
    <term>
     <parameter>wincache.ignorelist</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Define una lista de ficheros que no deberían ser almacenados en caché por la extensión.
      La lista de ficheros se especifica empleando solamente nombres de ficheros, separados por
      el símbolo tubería - "|".
      <example>
       <title>Ejemplo de <literal>wincache.ignorelist</literal></title>
       <programlisting role="ini">
<![CDATA[
wincache.ignorelist = "index.php|misc.php|admin.php"
]]>
       </programlisting>
      </example>
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.namesalt">
    <term>
     <parameter>wincache.namesalt</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      Define un string que será usado al nombrar los objetos específicos
      de la extensión que están almacenados en la memoria compartida. Se emplea
      para evitar conflictos que podrían causarse si otras aplicaciones dentro
      de un proceso obrero de IIS intenta acceder a la memoria compartida. La longitud
      del sting namesalt no puede exceder de 8 caracteres.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.ucenabled">
    <term>
     <parameter>wincache.ucenabled</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <simpara>
      Habilita o deshabilita la caché de usuarios.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.ucachesize">
    <term>
     <parameter>wincache.ucachesize</parameter>
     <type>int</type>
    </term>
    <listitem>
     <simpara>
      Define el tamaño máximo de memoria en megabytes que se asigna para la caché de usuario. Si el tamaño
      total de las variables almacenadas en la caché de usuario excede el valor especificado, se eliminarán
      las variables más antiguas de la caché.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.scachesize">
    <term>
     <parameter>wincache.scachesize</parameter>
     <type>int</type>
    </term>
    <listitem>
     <simpara>
      Define el tamaño máximo de memoria en megabytes que se asigna para la caché de sesión. Si el tamaño
      total de los datos almacenados en la caché de sesión excede el valor especificado, se eliminarán
      los datos más antiguos de la caché.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.rerouteini">
    <term>
     <parameter>wincache.rerouteini</parameter>
     <type>string</type>
    </term>
    <listitem>
     <warning xmlns="http://docbook.org/ns/docbook"><simpara>
      Esta opción ha sido <emphasis>eliminada</emphasis> a partir de 1.3.7.
      Véase <literal>wincache.reroute_enabled</literal> para una funcionalidad similar a partir de 1.3.7.
     </simpara></warning>
     <simpara>
      Especifica una ruta absoluta o relativa al fichero reroute.ini que contiene la lista de funciones de PHP
      cuya implementación debería ser remplazada con las funciones equivalentes de WinCache. Si se especifica una ruta relativa,
      se asume que sea relativa a la ubicación del fichero php-cgi.exe.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.reroute_enabled">
    <term>
     <parameter>wincache.reroute_enabled</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <simpara>
      Habilita o deshabilita el redireccionamiento de varias funciones de E/S de ficheros a través de la caché de ficheros.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.srwlocks">
    <term>
     <parameter>wincache.srwlocks</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta opción ha sido <emphasis>eliminada</emphasis> a partir de 2.0.0.0</simpara></warning>
     <simpara>
      Habilita o deshabilita el uso de bloqueos ("locks) de lectura/escritura compartidos. La deshabilitación es útil cuando se dan condiciones de problemas de punto muerto ("deadlock") en WinCache.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.wincache.filemapdir">
    <term>
     <parameter>wincache.filemapdir</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      Especifica una ruta absoluta al directorio donde WinCache almacenará los ficheros temporales empleados para segmentos de memoria compartida.
     </simpara>
     <simpara>
      Este directorio debe estar en la máquina local y no en un sistema de ficheros en la red.
     </simpara>
     <simpara>
      Si no se especifica este directorio, WinCache utilizará el fichero de paginación de Windows para todos los segmentos de memoria compartida.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>
</section>

<!-- 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
-->