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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 36a6e2aa5dbcf33088f34981ef3a5083fe02dd1a Maintainer: seros Status: ready -->
<!-- Reviewed: no -->

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

 <!-- {{{ Requirements -->
 <section xml:id="sdodasrel.requirements">
  &reftitle.required;
  <para>
   El DAS Relacional requiere que la extensión SDO esté instalada.
   La extensión SDO requiere una versión de PHP 5.1, y el
   DAS Relacional requiere una versión reciente que contenga
   un arreglo importante para PDO. La información más actualizada sobre
   los niveles requeridos de PHP deberían entcontrarse en el registro de cambis del
   paquete PECL. Sin embargo, en el momento de escribir esto, el DAS
   Relacional requiere el nivel beta más reciente de PHP 5.1, esto es
   PHP 5.1.0.
  </para>
  <para>
   El DAS Relacional usa PDO para acceder a la base de datos relacional,
   y por lo tanto debería ejecutarse con variedad de bases de datos relacionales diferentes.
   En el momento de escribir esto ha sido testeado en las siguientes configuraciones
   <itemizedlist>
    <listitem>
     <para>
      MySQL 4.1.14, en Windows. 
      El DAS Relacional opera correctamente con el controlador
      php_pdo_mysql que viene con los binarios preincluidos para PHP 5.1.0.
     </para>
    </listitem>
    <listitem>
     <para>
      MySQL 4.1.13, en Linux. Es necesario tener el controlador de PDO
      más actualizado para MySQL, el cual viene incluido con PHP 5.1.0. 
      Puede que sea necesario desinstalar el controlador usual que
      viene con PECL usando
      <command>pear uninstall pdo_mysql</command>.
      Se necesitará configurar PHP con al opción
      <command>--with-pdo-mysql</command>.
     </para>
    </listitem>
    <listitem>
     <para>
      DB2 8.2 Personal Edition, en Windows.
      El DAS Relacional opera correctamente con el
      controlador php_pdo_odbc que viene con los binarios preincluidos para
      PHP 5.1.0.
     </para>
    </listitem>
    <listitem>
     <para>
      DB2 8.2 Personal Developer's Edition, en Linux. 
      La Developer's Edition es necesaria ya que
      contiene ficheros necesarios cuando PHP es configurado
      y construido. Se necesitará configurar PHP con la opción
      <command>--with-pdo-odbc=ibm-db2</command>.
     </para>
    </listitem>
   </itemizedlist>
  </para>

  <para>
   El DAS Relacional aplica cambios a una base de datos dentro
   de una transacción delimitada por el usuario: esto es, emitirá una llamda a
   <function>PDO::beginTransaction</function>
   antes de empezar a aplicar cambios, y
   <function>PDO::commit</function>
   o
   <function>PDO::rollback</function>
   al completar.
   Sea cual sea la base de datos elegida, ésta y el controlador PDO para
   la base de datos deben soportar estas llamadas.
  </para>
 </section>
 <!-- }}} -->

 <!-- {{{ Installation -->
 <section xml:id="sdodasrel.installation">
  &reftitle.install;
  <para>
   Las instrucciones para la instalación de todos los componentes de SDO
   están en la sección
   <link linkend="sdo.installation">Instalación</link>
   de la documentación de SDO.
  </para>
  <para>
   En cualquier caso, los hechos esenciales son que
   el DAS Relacional está escrito en PHP y
   debería colocarse en algún lugar del
   <link linkend="ini.include-path">include_path</link> de PHP.
  </para>

  <para>
   La aplicación necesitará por supuesto incluir el DAS Relacioinal
   con una sentencia como esta:
   <programlisting role="php">
<![CDATA[
<?php
require_once 'SDO/DAS/Relational.php';
?>
]]>
   </programlisting>
  </para>
 </section>
 <!-- }}} -->

 <!-- {{{ Configuration -->
 <section xml:id="sdodasrel.configuration">
  &reftitle.runtime;
  &no.config;
  <section xml:id="sdodasrel.tracing">
   <title>Rastreo</title>
   <para>
    Puede interesar ver las sentencias SQL generadas
    para poder aplicar cambios en la base de datos. Al principio del
    <filename>SDO/DAS/Relational.php</filename>
    se encontrarán varias constantes que controlan si el proceso
    de construcción y ejecución de sentencias SQL es rastreado.
    Intente establecer
    <varname>DEBUG_EXECUTE_PLAN</varname>
    a &true; para ver las sentencias SQL generadas.
   </para>
  </section>
 </section>
 <!-- }}} -->

 <!-- {{{ Resources -->
 <section xml:id="sdodasrel.resources">
  &reftitle.resources;
  &no.resource;
 </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
-->