archived-doc-es/reference/mysqlnd_memcache/quickstart.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 86fe1b6af3972827827c20e6c5e27919073275b8 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="mysqlnd-memcache.quickstart" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Guía rápida y ejemplos</title>
 <para>
  El complemento de memcache para  mysqlnd es fácil de usar.
  Esta guía rápida mostrará los casos de uso típicos, y proporcionará consejos sobre
  cómo empezar a utilizarlo. 
 </para>
 <para>
  Se recomienda leer las secciones de referencia además de esta guía
  rápida. Aquí se intenta evitar tratar con conceptos teóricos
  y limitaciones. En su lugar, se enlazará con las secciones de referencia. Es seguro
  comenzar con esta guía rápida. Sin embargo, antes de usar el complemento en entornos de objetivos
  críticos, le animamos a que lea también la información de fondo de las
  secciones de referencia.
 </para>
 <section xml:id="mysqlnd-memcache.quickstart.configuration">
  <title>Configuración</title>
  <para>
   El complemento está implementado como una extensión de PHP. Ver también las
   <link linkend="mysqlnd-memcache.installation">instrucciones de instalación</link>
   para instalar esta extensión.
  </para>
  <para>  
   Compile o configure la extensión (API) de MySQL para PHP (<link linkend="ref.mysqli">mysqli</link>,
   <link linkend="ref.pdo-mysql">PDO_MYSQL</link>, <link linkend="ref.mysql">mysql</link>)
   Esta extensión debe utilizar la biblioteca <link linkend="book.mysqlnd">mysqlnd</link> debido
   a que mysqlnd_memcache es un complemento para la biblioteca mysqlnd. Para información adicional,
   consulte las <link linkend="memcached.installation">instrucciones de instalación de mysqlnd_memcache</link>.
  </para>
  <para>
   Después carque la extensión en PHP y active el complemento en el fichero de
   confuguración de PHP con la directiva de configuración llamada
   <link linkend="ini.mysqlnd-memcache.enable">mysqlnd_memcache.enable</link>.
  </para>
  <para>
   <example>
    <title>Habilitar el complemento (php.ini)</title>
    <programlisting role="ini">
<![CDATA[
; En Windows, el nombre del fichero es php_mysqnd_memcache.dll
; Cargar la extensión
extension=mysqlnd_memcache.so
; Habilitarla
mysqlnd_memcache.enable=1
]]>
    </programlisting>
   </example>
  </para>
  <para>
   Siga las instrucciones dadas en el <link xlink:href="&url.mysql.docs.memcached;">Manual
   de referencia de MySQL para la instalación de los comlementos de Memcache</link> para el servidor de MySQL.
   Active los complementos y configure el acceso a Memcache para tablas SQL.
  </para>
  <para>
   En los ejemplos de esta guía rápida se asume que existen las sibguientes tablas, y que
   Memcache está configurado con acceso al mismo.
  </para>
  <para>
   <example>
    <title>Tabla SQL empleada para la Guía rápida</title>
    <programlisting role="sql">
<![CDATA[
CREATE TABLE test(
  id CHAR(16),
  f1 VARCHAR(255),
  f2 VARCHAR(255),
  f3 VARCHAR(255),
  flags INT NOT NULL,
  cas_column INT,
  expire_time_column INT,
  PRIMARY KEY(id)
  ) ENGINE=InnoDB;

INSERT INTO test (id, f1, f2, f3) VALUES (1, 'Hello', 'World', '!');
INSERT INTO test (id, f1, f2, f3) VALUES (2, 'Lady', 'and', 'the tramp');

INSERT INTO innodb_memcache.containers(
  name, db_schema, db_table, key_columns, value_columns, 
  flags, cas_column, expire_time_column, unique_idx_name_on_key)
VALUES (
  'plugin_test', 'test', 'test', 'id', 'f1,f2,f3',
  'flags', 'cas_column', 'expire_time_column', 'PRIMARY KEY');
]]>
    </programlisting>
   </example>
  </para>
 </section>
 <section xml:id="mysqlnd-memcache.quickstart.usage">
  <title>Uso</title>
  <para>
   Después de asociar una conexión de MySQL con una conexión de Memcache utilizando
   <function>mysqnd_memcache_set</function>, el complemento intentará reemplazar
   de forma transparente las sentencias <literal>SELECT</literal> de SQL
   por un acceso a memcache. Para este propósito, el complemento monitoriza
   todas las sentencias SQL ejecutadas e intenta hacer coincidir el string de la sentencia
   con <constant>MYSQLND_MEMCACHE_DEFAULT_REGEXP</constant>.
   En caso de coincidir, el complemento de memcache para  mysqlnd comprueba si la
   <literal>SELECT</literal> está accediendo solamente a columnas de una tabla de correspondencias y
   la cláusula <literal>WHERE</literal> está limitada a una búsqueda de clave única.
  </para>
  <para>
   En el caso de la tabla tabla SQL de ejemplo, el complemento usrá la intefaz de Memcache
   del servidor de MySQL para obtener los resultados de una consulta SQL como
   <literal>SELECT f1, f2, f3 WHERE id = n</literal>.
  </para>
  <para>
   <example>
    <title>
     Ejemplo básico</title>
    
    <programlisting role="php">
<![CDATA[
<?php
$mysqli = new mysqli("host", "usuario", "contraseña", "base_de_datos");
$memc = new Memcached();
$memc->addServer("host", 11211);
mysqlnd_memcache_set($mysqli, $memc);

/*
   Esta es una consulta a la tabla test que emplea id como clave de la cláusula WHERE
   y que accede a los campos f1, f2 y f3. Por tanto, mysqlnd_memcache
   la interceptará y la redirigirá mediante memcache.
*/
$resultado = $mysqli->query("SELECT f1, f2, f3 FROM test WHERE id = 1");
while ($fila = $resultado->fetch_row()) {
    print_r($fila);
}

/*
   Esta es una consulta a la tabla test pero empleando f1 en la cláusula WHERE.
   Por tanto, mysqlnd_memcache no la interceptará. Se ejecutará
   empleando el protocolo de MySQL.
*/
$mysqli->query("SELECT id FROM test WHERE f1 = 'Lady'");
while ($fila = $resultado->fetch_row()) {
    print_r($fila);
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
array(
    [f1] => Hello
    [f2] => World
    [f3] => !
)
array(
    [id] => 2
)
]]>
    </screen>
   </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
-->