doc-fr/reference/pdo_ibm/reference.xml

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

<reference xml:id="ref.pdo-ibm" xmlns="http://docbook.org/ns/docbook">
 <?phpdoc extension-membership="pecl" ?>
 <title>Fonctions IBM (PDO_IBM)</title>
 <titleabbrev>IBM (PDO)</titleabbrev>
 <partintro>

  <section xml:id="pdo-ibm.intro">
   &reftitle.intro;
   <para>
    PDO_IBM est un driver qui implémente l'interface <link linkend="intro.pdo">
    <literal>PHP Data Objects</literal> (PDO)</link> afin d'activer l'accès 
    depuis PHP aux bases de données IBM.
   </para>
  </section>

  <!-- Informations trouvées dans configure.xml -->
  &reference.pdo-ibm.configure;
  <!-- Informations trouvées dans ini.xml -->
  &reference.pdo-ibm.ini;

 </partintro>

 <refentry xml:id="ref.pdo-ibm.connection">
  <refnamediv>
   <refname>PDO_IBM DSN</refname>
   <refpurpose>Connexion aux bases de données IBM</refpurpose>
  </refnamediv>

  <refsect1 role="description">
   &reftitle.description;
   <para>
    Le nom de la source de données PDO_IBM (DSN) est basé sur le IBM CLI DSN.
    Les principaux composants de PDO_IBM DSN sont :
    <variablelist>
     <varlistentry>
      <term>DSN prefix</term>
      <listitem>
       <para>
        Le préfixe DSN est <userinput>ibm:</userinput>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>DSN</term>
      <listitem>
       <para>
        Le DSN peut être une valeur parmi celles-ci :
        <itemizedlist>
         <listitem>
          <para>
           a) Configuration de la source des données en utilisant le fichier
           <filename>db2cli.ini</filename>
           ou <filename>odbc.ini</filename>
          </para>
         </listitem>
         <listitem>
          <para>
           b) Nom de base de données catalogué, i.e. alias de base de données contenus dans
           le catalogue du client DB2
          </para>
         </listitem>
         <listitem>
          <para>
           c) Chaîne de connexion complète dans le format suivant :
           <code>DRIVER={IBM DB2 ODBC DRIVER};DATABASE=<parameter>database</parameter>;HOSTNAME=<parameter>hostname</parameter>;PORT=<parameter>port</parameter>;PROTOCOL=TCPIP;UID=<parameter>username</parameter>;PWD=<parameter>password</parameter>;</code>
           où les paramètres représentent les valeurs suivantes :
           <variablelist>
            <varlistentry>
             <term><parameter>database</parameter></term>
             <listitem>
              <para>
               Le nom de la base de données.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>hostname</parameter></term>
             <listitem>
              <para>
               Le nom de l'hôte ou l'adresse IP du serveur de base de données.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>port</parameter></term>
             <listitem>
              <para>
               Le port TCP/IP sur lequel la base de données écoute les requêtes.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>username</parameter></term>
             <listitem>
              <para>
               Le nom d'utilisateur utilisé pour la connexion à la base de données.
              </para>
             </listitem>
            </varlistentry>
            <varlistentry>
             <term><parameter>password</parameter></term>
             <listitem>
              <para>
               Le mot de passe utilisé pour la connexion à la base de données.
              </para>
             </listitem>
            </varlistentry>
           </variablelist>
          </para>
         </listitem>
        </itemizedlist>
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
     <title>Exemple avec PDO_IBM DSN en utilisant <filename>db2cli.ini</filename></title>
     <para>
      L'exemple suivant montre l'utilisation de PDO_IBM DSN pour la connexion à une
      base de données DB2 cataloguée comme DB2_9 dans le fichier
      <filename>db2cli.ini</filename> :
      <programlisting>
<![CDATA[
$db = new PDO("ibm:DSN=DB2_9", "", "");

[DB2_9]
Database=testdb
Protocol=tcpip
Hostname=11.22.33.444
Servicename=56789
]]>
      </programlisting>
     </para>
    </example>
    <example>
     <title>Exemple avec PDO_IBM DSN en utilisant une chaîne complète de connexion</title>
     <para>
      L'exemple suivant montre l'utilisation de PDO_IBM DSN pour la connexion à une
      base de données DB2 nommé <userinput>testdb</userinput> en utilisant
      la chaîne complète de connexion DB2 CLI :
      <programlisting>
<![CDATA[
$db = new PDO("ibm:DRIVER={IBM DB2 ODBC DRIVER};DATABASE=testdb;" .
"HOSTNAME=11.22.33.444;PORT=56789;PROTOCOL=TCPIP;", "testuser", "tespass");
]]>
      </programlisting>
     </para>
    </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
-->