doc-fr/reference/pdo_odbc/reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4157259e8920fb618d5d23cb214950893d1c8931 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 ODBC et DB2 (PDO_ODBC)</title>
  <titleabbrev>ODBC et DB2 (PDO)</titleabbrev>
  <partintro>

   <section xml:id="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 de 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 vous vous
         connectez à une base de données cataloguée dans le pilote de ODBC
         Manager ou dans le catalogue de DB2, vous pouvez 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, vous pouvez fournir une
         chaîne de connexion complète pour ODBC pour vous 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 vous spécifiez
         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 vous
         spécifiez 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="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é <userinput>SAMPLE</userinput> en utilisant la
       syntaxe complète de 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é à
       <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
-->