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

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

<reference xml:id="ref.pdo-odbc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="bundledexternal" ?>
 <title>Funciones de ODBC y DB2 (PDO_ODBC)</title>
 <titleabbrev>ODBC y DB2 (PDO)</titleabbrev>
 <partintro>
  
  <section xml:id="pdo-odbc.intro">
   &reftitle.intro;
   <para>
    PDO_ODBC es un controlador que implementa la <link linkend="intro.pdo">interfaz de
    Objetos de datos de PHP (PDO)</link>
    para habilitar el acceso desde PHP a bases de datos a través de contorladores ODBC o
    de la biblioteca IBM DB2 Call Level Interface (DB2 CLI). PDO_ODBC admite actualmente
    tres "sabores" diferentes de controladores de bases de datos:
    <variablelist>
     <varlistentry>
      <term>ibm-db2</term>
      <listitem>
       <para>
        Da soporte para el acceso a servidores de IBM DB2 Universal Database, Cloudscape,
        y Apache a través del cliente gratuito DB2.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>unixODBC</term>
      <listitem>
       <para>
        Da soporte para el acceso a servidores de bases de datos a través del administrador
        de gestores de unixODBC y de los controladores de ODBC proppietarios de bases de datos. 
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>generic</term>
      <listitem>
       <para>
        Ofrece una opción de compilación para los administradores de gestores de ODBC que no
        están admitidos explícitamente pore PDO_ODBC.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
   <para>
    En Windows, PDO_ODBC está construido dentor del núcleo de PHP de manera predeterminada.
    Está vinculado con Windows ODBC Driver Manager, por lo que PHP puede conectarse a cualquier
    base de datos catalogada en un DSN de sistema, y es el controlador recomendado para
    conectarse a bases de datos de Microsoft SQL Server.
   </para>
  </section>
  
  <!-- Information found in configure.xml -->
  &reference.pdo-odbc.configure;
  <!-- Information found in ini.xml -->
  &reference.pdo-odbc.ini;
 </partintro>
 
 <refentry xml:id="ref.pdo-odbc.connection">
  <refnamediv>
   <refname>DSN de PDO_ODBC</refname>
   <refpurpose>Conectarse a bases de datos de ODBC o de DB2</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
   &reftitle.description;
   <para>
    El Nombre del Origen de Datos (DSN) de PDO_ODBC está compuesto por los siguientes elementos:
    <variablelist>
     <varlistentry>
      <term>Prefijo DSN</term>
      <listitem>
       <para>
        El prefijo DSN es <userinput>odbc:</userinput>. Si se realiza un conexión
        a una base de datos catalogada en el administrador de controladores de ODBC o en el catálogo
        de DB2, se puede añadir el nombre del catálogo de la base de datos al DSN.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>DSN</term>
      <listitem>
       <para>
        El nombre de la base de datos tal como está catalogada en el administrador de controladores de ODBC
        o en el catálogo de DB2. Alternativamente, se puede proporcionar una cadena de conexión de
        ODBC completa para conectarse a una base de datos como está descrito en
        <link xlink:href="&url.connectionstrings;">&url.connectionstrings;</link>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>UID</literal></term>
      <listitem>
       <para>
        El nombre del usuario para la conexión. Si se especifica el nombre de usuario
        en el DSN, PDO ignorará el valor del argumento de nombre de usuario en el
        constructor de PDO.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>PWD</literal></term>
      <listitem>
       <para>
        La contraseña del usuario para la conexión. Si se especifica la
        contraseña en el DSN, PDO ignorará el valor del argumento de contraseña
        en el constructor de PDO.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
     <title>Ejemplo de DSN de PDO_ODBC (administrador de controladores de ODBC)</title>
     <para>
      El siguiente ejemplo muestra un DSN de PDO_ODBC para conectarse a una base de datos
      de ODBC catalogada en testdb en el administrador de controladores de ODBC:
     </para>
<programlisting><![CDATA[
odbc:testdb
]]>
     </programlisting>
    </example>
    <example>
     <title>Ejemplo de DSN de PDO_ODBC (conexión no catalogada de IBM DB2)</title>
     <para>
      El siguiente ejemplo muestra un DSN de PDO_ODBC para conectarse a una base de datos
      de IBM DB2 llamada <userinput>SAMPLE</userinput> usando la sintaxis
      completa de DSN de ODBC:
     </para>
<programlisting><![CDATA[
odbc:DRIVER={IBM DB2 ODBC DRIVER};HOSTNAME=localhost;PORT=50000;DATABASE=SAMPLE;PROTOCOL=TCPIP;UID=db2inst1;PWD=ibmdb2;
]]>
     </programlisting>
    </example>
    <example>
     <title>Ejemplo de DSN de PDO_ODBC (conexión no catalogada de Microsoft Access)</title>
     <para>
      El siguiente ejemplo muestra un DSN de PDO_ODBC para conectarse a una base de datos
      de Microsoft Access almacenada en <userinput>C:\db.mdb</userinput> usando la sintaxis
      completa de DSN de ODBC:
     </para>
<programlisting><![CDATA[
odbc:Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\\db.mdb;Uid=Admin
]]>
     </programlisting>
    </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
-->