<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-odbc.connection.php',
    1 => 'PDO_ODBC DSN',
    2 => 'Conectando-se a bancos de dados ODBC ou DB2',
  ),
  'up' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'Driver PDO do ODBC e do DB2',
  ),
  'prev' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'Driver PDO do ODBC e do DB2',
  ),
  'next' => 
  array (
    0 => 'class.pdo-odbc.php',
    1 => 'Pdo\\Odbc',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    '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">Conectando-se a bancos de dados ODBC ou DB2</span></p>

  </div>

  <div class="refsect1 description" id="refsect1-ref.pdo-odbc.connection-description">
   <h3 class="title">Descrição</h3>
   <p class="para">
    O Nome da Fonte de Dados (DSN) PDO_ODBC é composto pelos seguintes elementos:
    <dl>
     
      <dt>Prefixo DSN</dt>
      <dd>
       <p class="para">
        O prefixo DSN é <strong class="userinput"><code>odbc:</code></strong>. Se estiver sendo feita uma conexão
        a um banco de dados catalogado no gerenciador de driver ODBC ou no catálogo do DB2,
        pode-se anexar o nome catalogado do banco de dados ao DSN.
       </p>
      </dd>
     
     
      <dt>DSN</dt>
      <dd>
       <p class="para">
        O nome do banco de dados conforme catalogado no gerenciador de driver ODBC ou
        no catálogo do DB2. Como alternativa, pode-se fornecer uma string de conexão ODBC completa
        para conectar-se a um banco de dados, conforme descrito em
        <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">
        O nome do usuário para a conexão. Se for especificado o nome de usuário
        no DSN, o PDO ignorará o valor do argumento do nome de usuário
        no construtor do PDO.
       </p>
      </dd>
     
     
      <dt><code class="literal">PWD</code></dt>
      <dd>
       <p class="para">
        A senha do usuário para a conexão. Se for especificada a senha
        no DSN, o PDO ignorará o valor do argumento de senha
        no construtor do PDO.
       </p>
      </dd>
     
    </dl>
   </p>
  </div>


  <div class="refsect1 changelog" id="refsect1-ref.pdo-odbc.connection-changelog">
   <h3 class="title">Registro de Alterações</h3>
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Versão</th>
       <th>Descrição</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>8.4.0</td>
       <td>
        Ao passar uma <span class="type"><a href="language.types.string.php" class="type string">string</a></span> vazia para o argumento de senha no construtor PDO, <code class="literal">pwd</code>
        não era incluído na string de conexão criada até agora, mas o comportamento foi alterado para incluí-lo
        como uma string vazia. Passando <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> para o argumento de senha no construtor PDO resulta no mesmo
        comportamento de antes.
       </td>
      </tr>

      <tr>
       <td>8.4.0</td>
       <td>
        Alterado o comportamento para ignorar o argumento do nome de usuário e o argumento da senha no construtor PDO
        separadamente quando o DSN contém <code class="literal">uid</code> ou <code class="literal">pwd</code>.
        Anteriormente, se incluído apenas <code class="literal">uid</code> ou <code class="literal">pwd</code> no DSN,
        tanto o argumento do nome de usuário quanto o argumento da senha no construtor PDO eram ignorados.
       </td>
      </tr>

     </tbody>
    
   </table>

  </div>


  <div class="refsect1 examples" id="refsect1-ref.pdo-odbc.connection-examples">
   <h3 class="title">Exemplos</h3>
   <p class="para">
    <div class="example" id="example-1">
     <p><strong>Exemplo #1 Exemplo de PDO_ODBC DSN (gerenciador de driver ODBC)</strong></p>
     <div class="example-contents"><p>
      O exemplo a seguir mostra um DSN PDO_ODBC para conexão a um banco de dados
      ODBC catalogado como testdb no gerenciador de driver ODBC:
     </p></div>
     <div class="example-contents"><div class="cdata"><pre>
odbc:testdb
</pre></div>
     </div>

    </div>
    <div class="example" id="example-2">
     <p><strong>Exemplo #2 Exemplo de DSN PDO_ODBC (conexão não catalogada do IBM DB2)</strong></p>
     <div class="example-contents"><p>
      O exemplo a seguir mostra um DSN PDO_ODBC para conexão a
      um banco de dados IBM DB2 denominado <strong class="userinput"><code>SAMPLE</code></strong> usando a sintaxe
      DSN ODBC completa:
     </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>Exemplo #3 Exemplo de PDO_ODBC DSN (conexão não catalogada do Microsoft Access)</strong></p>
     <div class="example-contents"><p>
      O exemplo a seguir mostra um DSN PDO_ODBC para conexão a
      um banco de dados Microsoft Access armazenado em <strong class="userinput"><code>C:\db.mdb</code></strong> usando a sintaxe
      DSN ODBC completa:
     </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); ?>