archived-doc-es/reference/pdo_ibm/reference.xml

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

<reference xml:id="ref.pdo-ibm" xmlns="http://docbook.org/ns/docbook">
 <?phpdoc extension-membership="pecl" ?>
 <title>Funciones del controlador PDO IBM (PDO_IBM)</title>
 <titleabbrev>Controlador PDO IBM</titleabbrev>
 <partintro>

  <section xml:id="pdo-ibm.intro">
   &reftitle.intro;
   <para>
    PDO_IBM es un driver que implementa la interfaz <link linkend="intro.pdo">
    <literal>PHP Data Objects</literal> (PDO)</link> para habilitar el acceso
    desde PHP a las bases de datos IBM.
   </para>
  </section>

  <!-- Informations trouvées dans configure.xml -->
  &reference.pdo-ibm.configure;
  <!-- Informations trouvées dans ini.xml -->
  &reference.pdo-ibm.ini;

 </partintro>

 <refentry xml:id="ref.pdo-ibm.connection">
  <refnamediv>
   <refname>PDO_IBM DSN</refname>
   <refpurpose>Conexión a las bases de datos IBM</refpurpose>
  </refnamediv>

  <refsect1 role="description">
   &reftitle.description;
   <para>
    El nombre de la fuente de datos PDO_IBM (DSN) se basa en el IBM CLI DSN.
    Los componentes principales de PDO_IBM DSN son :
    <variablelist>
     <varlistentry>
      <term>Prefijo DSN</term>
      <listitem>
       <para>
        El prefijo DSN es <userinput>ibm:</userinput>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>DSN</term>
      <listitem>
       <para>
        El DSN puede ser uno de los siguientes :
        <itemizedlist>
         <listitem>
          <para>
           a) Configuración de la fuente de datos utilizando el archivo
           <filename>db2cli.ini</filename>
           o <filename>odbc.ini</filename>
          </para>
         </listitem>
         <listitem>
          <para>
           b) Nombre de base de datos catalogado, es decir, alias de base de datos contenidos en
           el catálogo del cliente DB2
          </para>
         </listitem>
         <listitem>
          <para>
           c) Cadena de conexión completa en el siguiente formato :
           <code>DRIVER={IBM DB2 ODBC DRIVER};DATABASE=<parameter>database</parameter>;HOSTNAME=<parameter>hostname</parameter>;PORT=<parameter>port</parameter>;PROTOCOL=TCPIP;UID=<parameter>username</parameter>;PWD=<parameter>password</parameter>;</code>
           donde los parámetros representan los siguientes valores :
           <variablelist>
            <varlistentry>
             <term><parameter>database</parameter></term>
             <listitem>
              <para>
               El nombre de la base de datos.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>hostname</parameter></term>
             <listitem>
              <para>
               El nombre del host o la dirección IP del servidor de base de datos.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>port</parameter></term>
             <listitem>
              <para>
               El puerto TCP/IP en el que la base de datos escucha las consultas.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>username</parameter></term>
             <listitem>
              <para>
               El nombre de usuario utilizado para la conexión a la base de datos.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>password</parameter></term>
             <listitem>
              <para>
               La contraseña utilizada para la conexión a la base de datos.
              </para>
             </listitem>
            </varlistentry>
           </variablelist>
          </para>
         </listitem>
        </itemizedlist>
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
     <title>Ejemplo con PDO_IBM DSN utilizando <filename>db2cli.ini</filename></title>
     <para>
      El siguiente ejemplo muestra el uso de PDO_IBM DSN para la conexión a una
      base de datos DB2 catalogada como DB2_9 en el archivo
      <filename>db2cli.ini</filename> :
      <programlisting>
<![CDATA[
$db = new PDO("ibm:DSN=DB2_9", "", "");

[DB2_9]
Database=testdb
Protocol=tcpip
Hostname=11.22.33.444
Servicename=56789
]]>
      </programlisting>
     </para>
    </example>
    <example>
     <title>Ejemplo con PDO_IBM DSN utilizando una cadena completa de conexión</title>
     <para>
      El siguiente ejemplo muestra el uso de PDO_IBM DSN para la conexión a una
      base de datos DB2 llamada <userinput>testdb</userinput> utilizando
      la cadena completa de conexión DB2 CLI :
      <programlisting>
<![CDATA[
$db = new PDO("ibm:DRIVER={IBM DB2 ODBC DRIVER};DATABASE=testdb;" .
"HOSTNAME=11.22.33.444;PORT=56789;PROTOCOL=TCPIP;", "testuser", "tespass");
]]>
      </programlisting>
     </para>
    </example>
   </para>
  </refsect1>
 </refentry>
</reference>

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