<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.pdo-odbc.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-odbc.connection.php',
    1 => 'PDO_ODBC DSN',
    2 => 'Conexi&oacute;n a bases de datos ODBC o DB2',
  ),
  'up' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'Controladores PDO ODBC y DB2',
  ),
  'prev' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'Controladores PDO ODBC y DB2',
  ),
  'next' => 
  array (
    0 => 'class.pdo-odbc.php',
    1 => 'Pdo\\Odbc',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/pdo_odbc/reference.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-odbc.connection" class="refentry">
   <div class="refnamediv">
    <h1 class="refname">PDO_ODBC DSN</h1>
    <p class="verinfo">(PECL PDO_ODBC &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">PDO_ODBC DSN</span> &mdash; <span class="dc-title">Conexión a bases de datos ODBC o DB2</span></p>

   </div>

   <div class="refsect1 description" id="refsect1-ref.pdo-odbc.connection-description">
    <h3 class="title">Descripción</h3>
    <p class="para">
     El Data Source Name (DSN) de PDO_ODBC se compone de los siguientes elementos:
     <dl>
      
       <dt>Prefijo DSN</dt>
       <dd>
        <p class="para">
         El prefijo DSN es <strong class="userinput"><code>odbc:</code></strong>. Si se conecta a una base de datos catalogada en el controlador de ODBC
         Manager o en el catálogo de DB2, se puede añadir el nombre del catálogo de la base de datos al DSN.
        </p>
       </dd>
      
      
       <dt>DSN</dt>
       <dd>
        <p class="para">
         El nombre de la base de datos catalogada en el controlador ODBC
         Manager o el catálogo DB2. Alternativamente, se puede proporcionar una
         cadena de conexión completa para ODBC para conectarse a una base de
         datos como se describe en
         <a href="http://www.connectionstrings.com/" class="link external">&raquo;&nbsp;http://www.connectionstrings.com/</a>.
        </p>
       </dd>
      
      
       <dt><code class="literal">UID</code></dt>
       <dd>
        <p class="para">
         El nombre de usuario para la conexión. Si se especifica el usuario en el DSN, PDO ignorará el valor del usuario en el argumento en el constructor PDO.
        </p>
       </dd>
      
      
       <dt><code class="literal">PWD</code></dt>
       <dd>
        <p class="para">
         La contraseña del usuario para la conexión. Si se especifica la contraseña en el DSN, PDO ignorará el valor de la contraseña en el argumento en el constructor PDO.
        </p>
       </dd>
      
     </dl>
    </p>
   </div>

   <div class="refsect1 changelog" id="refsect1-ref.pdo-odbc.connection-changelog">
    <h3 class="title">Historial de cambios</h3>
    <table class="doctable informaltable">
     
      <thead>
       <tr>
        <th>Versión</th>
        <th>Descripción</th>
       </tr>

      </thead>

      <tbody class="tbody">
       <tr>
        <td>8.4.0</td>
        <td>
         Al pasar una <span class="type"><a href="language.types.string.php" class="type string">string</a></span> vacía al argumento de contraseña en el constructor PDO, <code class="literal">pwd</code>
         no se incluía en la cadena de conexión creada hasta ahora, pero el comportamiento ha sido modificado para incluirla
         como una cadena vacía. Pasar <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> para el argumento de contraseña en el constructor PDO produce el mismo
         comportamiento que antes.
        </td>
       </tr>

       <tr>
        <td>8.4.0</td>
        <td>
         Cambio de comportamiento para ignorar por separado el argumento de nombre de usuario y el argumento de contraseña en el constructor PDO
         cuando el DSN contiene <code class="literal">uid</code> o <code class="literal">pwd</code>.
         Anteriormente, si cualquiera de <code class="literal">uid</code> o <code class="literal">pwd</code> estaba incluido en el DSN,
         los argumentos de nombre de usuario y contraseña en el constructor PDO eran ignorados.
        </td>
       </tr>

      </tbody>
     
    </table>

   </div>

   <div class="refsect1 examples" id="refsect1-ref.pdo-odbc.connection-examples">
    <h3 class="title">Ejemplos</h3>
    <p class="para">
     <div class="example" id="example-1">
      <p><strong>Ejemplo #1 Ejemplo con PDO_ODBC DSN (controlador ODBC Manager)</strong></p>
      <div class="example-contents"><p>
       El siguiente ejemplo muestra PDO_ODBC DSN para conectarse a una base
       de datos ODBC catalogada como testdb en el controlador ODBC
       Manager:
      </p></div>
      <div class="example-contents"><div class="cdata"><pre>
odbc:testdb
</pre></div>
       </div>

     </div>
     <div class="example" id="example-2">
      <p><strong>Ejemplo #2 Ejemplo con PDO_ODBC DSN (conexión no catalogada IBM DB2)</strong></p>
      <div class="example-contents"><p>
       El siguiente ejemplo muestra PDO_ODBC DSN para conectarse a una base
       de datos IBM DB2 llamada <strong class="userinput"><code>SAMPLE</code></strong> utilizando la
       sintaxis completa de ODBC DSN:
      </p></div>
      <div class="example-contents"><div class="cdata"><pre>
odbc:DRIVER={IBM DB2 ODBC DRIVER};HOSTNAME=localhost;PORT=50000;DATABASE=SAMPLE;PROTOCOL=TCPIP;UID=db2inst1;PWD=ibmdb2;
</pre></div>
      </div>

     </div>
     <div class="example" id="example-3">
      <p><strong>Ejemplo #3 Ejemplo con PDO_ODBC DSN (conexión no catalogada Microsoft Access)</strong></p>
      <div class="example-contents"><p>
       El siguiente ejemplo muestra PDO_ODBC DSN para conectarse a una base
       de datos Microsoft Access registrada en
       <strong class="userinput"><code>C:\db.mdb</code></strong> utilizando la sintaxis completa
       de ODBC DSN:
      </p></div>
      <div class="example-contents"><div class="cdata"><pre>
odbc:Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\\db.mdb;Uid=Admin
</pre></div>
      </div>

     </div>

    </p>
   </div>

  </div><?php manual_footer($setup); ?>