archived-doc-es/reference/wincache/setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->

<chapter xml:id="wincache.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

 <section xml:id="wincache.requirements">
  &reftitle.required;
  <para>
   La extensión actualmente solo es compatible con las siguientes configuraciones:
  </para>
  <simpara>Sistema Operativo Windows:</simpara>
  <itemizedlist spacing="compact">
   <listitem>
    <simpara>Windows XP SP3 con IIS 5.1 y la <link xlink:href="&url.iis.fastcgi.downloads;">Extensión FastCGI</link></simpara>
   </listitem>
   <listitem>
    <simpara>Windows Server 2003 con IIS 6.0 y la <link xlink:href="&url.iis.fastcgi.downloads;">Extensión FastCGI</link></simpara>
   </listitem>
   <listitem>
    <simpara>Windows Vista SP1 con IIS 7.0 y el módulo FastCGI</simpara>
   </listitem>
   <listitem>
    <simpara>Windows Server 2008 con IIS 7.0 y el módulo FastCGI</simpara>
   </listitem>
   <listitem>
    <simpara>Windows 7 con IIS 7.5 y el módulo FastCGI</simpara>
   </listitem>
   <listitem>
    <simpara>Windows Server 2008 R2 con IIS 7.5 y el módulo FastCGI</simpara>
   </listitem>
  </itemizedlist>
  <simpara>PHP:</simpara>
  <itemizedlist spacing="compact">
   <listitem>
    <simpara>PHP 5.2.X, compilación no segura para subprocesos</simpara>
   </listitem>
   <listitem>
    <simpara>PHP 5.3 X86, compilación VC9 no segura para subprocesos</simpara>
   </listitem>
  </itemizedlist>
  <note>
   <simpara>
    La extensión WinCache solo puede ser utilizada cuando IIS está configurado para ejecutar PHP a través de FastCGI.
   </simpara>
  </note>
 </section>
 <section xml:id="wincache.installation">
  &reftitle.install;
  <para>
   &pecl.moved;
  </para>
  <para>
   &pecl.info;
   <link xlink:href="&url.pecl.package;wincache">&url.pecl.package;wincache</link>.
  </para>
  <para>
   Hay dos paquetes para esta extensión: un paquete es para las versiones PHP 5.2.X,
   y el otro paquete es para PHP 5.3.X. Elija el paquete adecuado para la versión de PHP
   que esté utilizando.
  </para>
  <para>
   Para instalar y activar la extensión, siga estos pasos:
  </para>
  <procedure>
   <step>
    <simpara>
     Descomprima el paquete en una ubicación temporal.
    </simpara>
   </step>
   <step>
    <simpara>
     Copie el archivo <filename>php_wincache.dll</filename> en la carpeta de extensiones PHP.
     Generalmente, esta carpeta se llama "ext" y está ubicada en el mismo directorio que todos
     los archivos binarios de PHP. Por ejemplo: <filename>C:\Program Files\PHP\ext</filename>.
    </simpara>
   </step>
   <step>
    <simpara>
     Con un editor de texto, abra el archivo php.ini, que generalmente se encuentra en el mismo
     directorio que todos los archivos binarios de PHP. Por ejemplo:
     <filename>C:\Program Files\PHP\php.ini</filename>.
    </simpara>
   </step>
   <step>
    <simpara>
     Agregue la siguiente línea al final del archivo php.ini:
     <literal>extension = php_wincache.dll</literal>.
    </simpara>
   </step>
   <step>
    <simpara>
     Guarde y cierre el archivo <filename>php.ini</filename>.
    </simpara>
   </step>
   <step>
    <simpara>
     Reinicie el grupo de aplicaciones IIS para que PHP recoja los cambios de configuración. Para verificar que la extensión se ha activado, cree un archivo llamado
     <filename>phpinfo.php</filename> que contenga una llamada a la función
     <link linkend="function.phpinfo">phpinfo</link>.
    </simpara>
   </step>
   <step>
    <simpara>
     Guarde el archivo <filename>phpinfo.php</filename> en el directorio raíz de un
     sitio web IIS que utilice PHP, luego abra un navegador y realice una solicitud a
     http://localhost/phpinfo.php. Busque una sección llamada <literal>wincache</literal>
     en la página devuelta. Si la extensión está activada, la salida de
     <link linkend="function.phpinfo">phpinfo</link> listará los parámetros de configuración
     proporcionados por WinCache.
    </simpara>
   </step>
  </procedure>
  <note>
   <simpara>
    No olvide eliminar el archivo <filename>phpinfo.php</filename> del directorio raíz después de haber verificado que la extensión se ha activado.
   </simpara>
  </note>
 </section>
 &reference.wincache.ini;

 <section xml:id="wincache.stats">
  <title>Script de estadísticas WinCache</title>
  <para>
   El paquete de instalación para WinCache incluye un script PHP,
   <filename>wincache.php</filename>, que puede ser utilizado para obtener información y estadísticas sobre la caché.
  </para>
  <para>
   Si la extensión WinCache se instaló a través del instalador de Microsoft Web Platform,
   entonces este script se encuentra en
   <filename>%SystemDrive%\Program Files\IIS\Windows Cache for PHP\</filename>.
   En una versión de 64 bits del sistema operativo Windows Server, el script se encuentra en
   <filename>%SystemDrive%\Program Files (x86)\IIS\Windows Cache for PHP</filename>.
   Si la extensión se instaló manualmente, entonces el archivo <filename>wincache.php</filename>
   estará ubicado en el mismo directorio desde el cual se extrajo el contenido del paquete de instalación.
  </para>
  <para>
   Para usar <filename>wincache.php</filename>, cópielo en el directorio raíz de un sitio web o
   en cualquier subdirectorio. Para proteger el script, ábralo en cualquier editor y
   reemplace los valores de las constantes <emphasis>USERNAME</emphasis> y <emphasis>PASSWORD</emphasis>. Si alguna otra autenticación IIS está habilitada en el servidor, entonces siga las instrucciones
   en los comentarios:
   <example>
    <title>Configuración de la autenticación para <filename>wincache.php</filename></title>
    <programlisting role="php">
<![CDATA[
<?php
/**
 * ======================== CONFIGURACIÓN DE AJUSTES ==============================
 * Si no desea usar la autenticación para esta página, establezca USE_AUTHENTICATION en 0.
 * Si usa autenticación, reemplace la contraseña predeterminada.
 */
define('USE_AUTHENTICATION', 1);
define('USERNAME', 'wincache');
define('PASSWORD', 'wincache');

/**
 * La autenticación PHP básica solo funcionará cuando IIS esté configurado para admitir
 * 'Autenticación anónima' y nada más. Si IIS está configurado para admitir/usar
 * cualquier otro tipo de autenticación como Básica/Negociar/Digest, etc., esto no funcionará.
 * En ese caso, use la matriz a continuación para definir los nombres de los usuarios en su
 * dominio/red/grupo de trabajo a los que desea otorgar acceso.
 */
$user_allowed = array('DOMAIN\user1', 'DOMAIN\user2', 'DOMAIN\user3');

/**
 * Si la matriz contiene la cadena 'all', entonces todos los usuarios autenticados por IIS
 * tendrán acceso a la página. Descomente la línea a continuación y comente la línea anterior
 * para otorgar acceso a todos los usuarios que sean autenticados por IIS.
 */
/* $user_allowed = array('all'); */

/** ===================== FIN DE CONFIGURACIÓN DE AJUSTES ========================== */
?>
]]>
    </programlisting>
   </example>
   <note>
    <simpara>
     Siempre proteja el script <filename>wincache.php</filename> utilizando el mecanismo de autenticación integrado o el mecanismo de autenticación del servidor. Dejar este script sin protección puede comprometer la seguridad de su aplicación web
     y del servidor.
    </simpara>
   </note>
  </para>
 </section>
 <section xml:id="wincache.sessionhandler">
  <title>Manejador de sesiones WinCache</title>
  <para>
   El manejador de sesiones WinCache (disponible desde WinCache 1.1.0) puede ser utilizado
   para configurar PHP para almacenar los datos de sesión en la memoria compartida del caché de sesión.
   El uso de la memoria compartida en lugar de la sesión predeterminada ayuda a mejorar el rendimiento
   de las aplicaciones PHP que almacenan grandes cantidades de datos en objetos de sesión.
   El caché de sesión Wincache utiliza archivos basados en memoria compartida, lo que
   asegura que los datos de sesión no se perderán durante el reciclaje de la cola de aplicaciones IIS.
  </para>
  <para>
   Para configurar PHP para usar el manejador de sesiones WinCache, establezca el parámetro
   <link linkend="ini.session.save-handler">session.save_handler</link> del archivo
   <filename>php.ini</filename> a <emphasis>wincache</emphasis>.
   De forma predeterminada, la ubicación donde se almacenan los archivos temporales en Windows se usa
   para almacenar los datos de sesión. Para cambiar esta ubicación, use la directiva
   <link linkend="ini.session.save-path">session.save_path</link>.
   <example>
    <title>Activar el manejador de sesiones WinCache</title>
    <programlisting role="php.ini">
<![CDATA[
session.save_handler = wincache
session.save_path = C:\inetpub\temp\session\
]]>
    </programlisting>
   </example>
  </para>
 </section>
 <section xml:id="wincache.reroutes">
 <title>Redirecciones de funciones WinCache</title>
 <para>
  <emphasis>NOTA:</emphasis>
  <link linkend="ini.wincache.rerouteini">wincache.rerouteini</link>
  fue eliminado con WinCache 1.3.7.0. Esto ha sido reemplazado por el redireccionamiento automático de funciones. Ver:
  <link linkend="ini.wincache.reroute_enabled">wincache.reroute_enabled</link>
  </para>
  <para>
   Las funcionalidades de redireccionamiento de funciones de WinCache (disponibles
   desde WinCache 1.2.0, eliminadas desde WinCache 1.3.7.0) pueden ser utilizadas para reemplazar funciones PHP nativas por sus equivalentes optimizados para casos particulares. La extensión
   Wincache incluye implementaciones de funciones PHP optimizadas para Windows,
   especialmente en casos de acceso a red o sistema de archivos.
   Las siguientes funciones están involucradas:
  </para>
  <itemizedlist spacing="compact">
   <listitem>
    <simpara>
     <link linkend="function.file-exists">file_exists</link>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <link linkend="function.file-get-contents">file_get_contents</link>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <link linkend="function.readfile">readfile</link>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <link linkend="function.is-readable">is_readable</link>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <link linkend="function.is-writable">is_writable</link>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <link linkend="function.is-dir">is_dir</link>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <link linkend="function.realpath">realpath</link>
    </simpara>
   </listitem>
      <listitem>
    <simpara>
     <link linkend="function.filesize">filesize</link>
    </simpara>
   </listitem>
  </itemizedlist>
  <para>
   Para configurar el redireccionamiento de funciones con Wincache, use el archivo
   <filename>reroute.ini</filename> incluido en el paquete. Cópielo en el directorio
   donde se encuentra <filename>php.ini</filename>. Luego, agregue wincache.rerouteini en
   <filename>php.ini</filename> y especifique la ruta absoluta o relativa a
   <filename>reroute.ini</filename>.
   <example>
    <title>Activación de las funcionalidades de redireccionamiento de funciones de WinCache</title>
    <programlisting role="php.ini">
<![CDATA[
wincache.rerouteini = C:\PHP\reroute.ini
]]>
    </programlisting>
   </example>
  </para>
  <note>
   <simpara>
    Si está habilitado, se recomienda aumentar el tamaño del caché de archivos. Esto se puede hacer
    usando el parámetro <link linkend="ini.wincache.fcachesize">wincache.fcachesize</link>.
   </simpara>
  </note>
  <para>
   El archivo <filename>reroute.ini</filename> contiene la correspondencia entre la función PHP nativa y
   el equivalente de Wincache. Cada línea en el archivo define una correspondencia. Aquí está la sintaxis:
  </para>
  <simpara>
   <literal>&lt;Nombre de la función PHP&gt;:[&lt;número de parámetros de la función&gt;]=&lt;nombre de la función wincache&gt;</literal>
  </simpara>
  <para>
   A continuación se muestra un ejemplo de archivo. En este ejemplo, las llamadas a las funciones PHP
   <function>file_get_contents</function> serán reemplazadas por <function>wincache_file_get_contents</function>
   solo si el número de parámetros pasados a la función es menor o igual a dos. Es útil especificar el número de parámetros cuando la función de reemplazo no está diseñada para usar todos ellos.
   <example>
    <title>Reroute.ini</title>
    <programlisting role="php.ini">
 <![CDATA[
[FunctionRerouteList]
file_exists=wincache_file_exists
file_get_contents:2=wincache_file_get_contents
readfile:2=wincache_readfile
is_readable=wincache_is_readable
is_writable=wincache_is_writable
is_writeable=wincache_is_writable
is_file=wincache_is_file
is_dir=wincache_is_dir
realpath=wincache_realpath
filesize=wincache_filesize
]]>
    </programlisting>
   </example>
  </para>
 </section>
</chapter>

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