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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c39225b6dd23f358824f44f5b8c733517b11830b Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

 <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>Fonctions du pilote PDO ODBC et DB2 (PDO_ODBC)</title>
  <titleabbrev>Pilotes PDO ODBC et DB2</titleabbrev>
  <partintro>

   <section xml:id="ref.pdo-odbc.intro">
   &reftitle.intro;
    <para>
     PDO_ODBC est un pilote qui implémente l'<link
     linkend="intro.pdo">interface de PHP Data Objects (PDO)</link> pour
     autoriser l'accès de PHP aux bases de données par les pilotes d'ODBC
     ou par la bibliothèque d'interface IBM DB2 Call Level (DB2 CLI). PDO_ODBC
     supporte actuellement trois "saveurs" différentes des pilotes de bases de
     données :
     <variablelist>
      <varlistentry>
       <term>ibm-db2</term>
       <listitem>
        <para>
         Supporte l'accès à <literal>IBM DB2 Universal Database</literal>, 
         Cloudscape et Apache Derby Server à l'aide du client gratuit DB2 express-C.
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>unixODBC</term>
       <listitem>
        <para>
         Supporte l'accès aux serveurs de base de données à l'aide du pilote
         de gestion unixODBC et les bases de données possédées par les pilotes
         ODBC.
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>generic</term>
       <listitem>
        <para>
         Offre une option de compilation pour les pilotes de gestion ODBC qui
         ne sont pas explicitement supportés par PDO_ODBC.
        </para>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
    <para>
     Sur Windows, <filename>php_pdo_odbc.dll</filename> doit être activé en tant qu'extension dans &php.ini;. Il
     est lié avec le Windows ODBC Driver Manager, c'est pourquoi PHP peut se
     connecter à n'importe quelle base de données cataloguée comme étant un
     System DSN.
    </para>
   </section>

   <!-- Information found in configure.xml -->
   &reference.pdo-odbc.configure;
   <!-- Information found in constants.xml -->
   &reference.pdo-odbc.constants;
  <!-- Information found in ini.xml -->
   &reference.pdo-odbc.ini;
  </partintro>

  <refentry xml:id="ref.pdo-odbc.connection">
   <refnamediv>
    <refname>PDO_ODBC DSN</refname>
    <refpurpose>Connexion aux bases de données ODBC ou DB2</refpurpose>
   </refnamediv>

   <refsect1 role="description">
    &reftitle.description;
    <para>
     Le Data Source Name (DSN) de PDO_ODBC est composé des éléments suivants :
     <variablelist>
      <varlistentry>
       <term>Préfixe DSN</term>
       <listitem>
        <para>
         Le préfixe DSN est <userinput>odbc:</userinput>. Si l'on se
         connecte à une base de données cataloguée dans le pilote d'ODBC
         Manager ou dans le catalogue de DB2, il est possible d'ajouter le nom du
         catalogue de la base de données au DSN.
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>DSN</term>
       <listitem>
        <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 à
         <link xlink:href="&url.connectionstrings;">&url.connectionstrings;</link>.
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>UID</literal></term>
       <listitem>
        <para>
         Le nom de l'utilisateur pour la connexion. Si l'on spécifie
         l'utilisateur dans le DSN, PDO ignorera la valeur de l'utilisateur en
         argument dans le constructeur PDO.
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>PWD</literal></term>
       <listitem>
        <para>
         Le mot de passe de l'utilisateur pour la connexion. Si l'on
         spécifie le mot de passe dans le DSN, PDO ignorera la valeur du mot
         de passe en argument dans le constructeur PDO.
        </para>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
   </refsect1>
   <refsect1 role="changelog">
    &reftitle.changelog;
    <informaltable>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>&Version;</entry>
        <entry>&Description;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>8.4.0</entry>
        <entry>
         Lors du passage d'une <type>string</type> vide à l'argument mot de passe dans le constructeur PDO, <literal>pwd</literal>
         n'était pas inclus dans la chaîne de connexion créée jusqu'à présent, mais le comportement a été modifié pour l'inclure
         en tant que chaîne vide. Passer &null; pour l'argument mot de passe dans le constructeur PDO entraîne le même
         comportement qu'auparavant.
        </entry>
       </row>
       <row>
        <entry>8.4.0</entry>
        <entry>
         Changement du comportement pour ignorer séparément l'argument nom d'utilisateur et l'argument mot de passe dans le constructeur PDO
         lorsque le DSN contient <literal>uid</literal> ou <literal>pwd</literal>.
         Auparavant, si l'un ou l'autre de <literal>uid</literal> ou <literal>pwd</literal> était inclus dans le DSN,
         les arguments nom d'utilisateur et mot de passe dans le constructeur PDO étaient ignorés.
        </entry>
       </row>
      </tbody>
     </tgroup>
    </informaltable>
   </refsect1>
   <refsect1 role="examples">
    &reftitle.examples;
    <para>
     <example>
      <title>Exemple avec PDO_ODBC DSN (pilote ODBC Manager)</title>
      <para>
       L'exemple suivant montre PDO_ODBC DSN pour se connecter à une base
       de données ODBC catalogué comme étant testdb dans le pilote ODBC
       Manager :
      </para>
      <programlisting><![CDATA[
odbc:testdb
]]>
       </programlisting>
     </example>
     <example>
      <title>Exemple avec PDO_ODBC DSN (connexion non cataloguée IBM DB2)</title>
      <para>
       L'exemple suivant montre PDO_ODBC DSN pour se connecter à une base
       de données IBM DB2 nommée <userinput>SAMPLE</userinput> en utilisant la
       syntaxe complète d'ODBC DSN :
      </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>Exemple avec PDO_ODBC DSN (connexion non cataloguée Microsoft Access)</title>
      <para>
       L'exemple suivant montre PDO_ODBC DSN pour se connecter à une base
       de données Microsoft Access enregistrée à
       <userinput>C:\db.mdb</userinput> en utilisant la syntaxe complète de
       ODBC DSN :
      </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
-->