<?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 => 'fr',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-odbc.connection.php',
    1 => 'PDO_ODBC DSN',
    2 => 'Connexion aux bases de donn&eacute;es ODBC ou DB2',
  ),
  'up' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'Pilotes PDO ODBC et DB2',
  ),
  'prev' => 
  array (
    0 => 'ref.pdo-odbc.php',
    1 => 'Pilotes PDO ODBC et DB2',
  ),
  'next' => 
  array (
    0 => 'class.pdo-odbc.php',
    1 => 'Pdo\\Odbc',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    '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">Connexion aux bases de données ODBC ou DB2</span></p>

   </div>

   <div class="refsect1 description" id="refsect1-ref.pdo-odbc.connection-description">
    <h3 class="title">Description</h3>
    <p class="para">
     Le Data Source Name (DSN) de PDO_ODBC est composé des éléments suivants :
     <dl>
      
       <dt>Préfixe DSN</dt>
       <dd>
        <p class="para">
         Le préfixe DSN est <strong class="userinput"><code>odbc:</code></strong>. Si l&#039;on se
         connecte à une base de données cataloguée dans le pilote d&#039;ODBC
         Manager ou dans le catalogue de DB2, il est possible d&#039;ajouter le nom du
         catalogue de la base de données au DSN.
        </p>
       </dd>
      
      
       <dt>DSN</dt>
       <dd>
        <p class="para">
         Le nom de la base de données étant catalogué dans le pilote ODBC
         Manager ou le catalogue DB2. Alternativement, il est possible de fournir une
         chaîne de connexion complète pour ODBC pour se connecter à une base
         de données comme décrit à
         <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">
         Le nom de l&#039;utilisateur pour la connexion. Si l&#039;on spécifie
         l&#039;utilisateur dans le DSN, PDO ignorera la valeur de l&#039;utilisateur en
         argument dans le constructeur PDO.
        </p>
       </dd>
      
      
       <dt><code class="literal">PWD</code></dt>
       <dd>
        <p class="para">
         Le mot de passe de l&#039;utilisateur pour la connexion. Si l&#039;on
         spécifie le mot de passe dans le DSN, PDO ignorera la valeur du mot
         de passe en argument dans le constructeur PDO.
        </p>
       </dd>
      
     </dl>
    </p>
   </div>

   <div class="refsect1 changelog" id="refsect1-ref.pdo-odbc.connection-changelog">
    <h3 class="title">Historique</h3>
    <table class="doctable informaltable">
     
      <thead>
       <tr>
        <th>Version</th>
        <th>Description</th>
       </tr>

      </thead>

      <tbody class="tbody">
       <tr>
        <td>8.4.0</td>
        <td>
         Lors du passage d&#039;une <span class="type"><a href="language.types.string.php" class="type string">string</a></span> vide à l&#039;argument mot de passe dans le constructeur PDO, <code class="literal">pwd</code>
         n&#039;était pas inclus dans la chaîne de connexion créée jusqu&#039;à présent, mais le comportement a été modifié pour l&#039;inclure
         en tant que chaîne vide. Passer <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> pour l&#039;argument mot de passe dans le constructeur PDO entraîne le même
         comportement qu&#039;auparavant.
        </td>
       </tr>

       <tr>
        <td>8.4.0</td>
        <td>
         Changement du comportement pour ignorer séparément l&#039;argument nom d&#039;utilisateur et l&#039;argument mot de passe dans le constructeur PDO
         lorsque le DSN contient <code class="literal">uid</code> ou <code class="literal">pwd</code>.
         Auparavant, si l&#039;un ou l&#039;autre de <code class="literal">uid</code> ou <code class="literal">pwd</code> était inclus dans le DSN,
         les arguments nom d&#039;utilisateur et mot de passe dans le constructeur PDO étaient ignorés.
        </td>
       </tr>

      </tbody>
     
    </table>

   </div>

   <div class="refsect1 examples" id="refsect1-ref.pdo-odbc.connection-examples">
    <h3 class="title">Exemples</h3>
    <p class="para">
     <div class="example" id="example-1">
      <p><strong>Exemple #1 Exemple avec PDO_ODBC DSN (pilote ODBC Manager)</strong></p>
      <div class="example-contents"><p>
       L&#039;exemple suivant montre PDO_ODBC DSN pour se connecter à une base
       de données ODBC catalogué comme étant testdb dans le pilote 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>Exemple #2 Exemple avec PDO_ODBC DSN (connexion non cataloguée IBM DB2)</strong></p>
      <div class="example-contents"><p>
       L&#039;exemple suivant montre PDO_ODBC DSN pour se connecter à une base
       de données IBM DB2 nommée <strong class="userinput"><code>SAMPLE</code></strong> en utilisant la
       syntaxe complète d&#039;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>Exemple #3 Exemple avec PDO_ODBC DSN (connexion non cataloguée Microsoft Access)</strong></p>
      <div class="example-contents"><p>
       L&#039;exemple suivant montre PDO_ODBC DSN pour se connecter à une base
       de données Microsoft Access enregistrée à
       <strong class="userinput"><code>C:\db.mdb</code></strong> en utilisant la syntaxe complète 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); ?>