<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/pdo.drivers.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-ibm.php',
    1 => 'Pilote PDO IBM',
    2 => 'Fonctions du pilote PDO IBM (PDO_IBM)',
  ),
  'up' => 
  array (
    0 => 'pdo.drivers.php',
    1 => 'Pilotes PDO',
  ),
  'prev' => 
  array (
    0 => 'pdo-firebird.getapiversion.php',
    1 => 'Pdo\\Firebird::getApiVersion',
  ),
  'next' => 
  array (
    0 => 'ref.pdo-ibm.connection.php',
    1 => 'PDO_IBM DSN',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/pdo_ibm/reference.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/ref.pdo-ibm.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-ibm" class="reference">
 
 <h1 class="title">Fonctions du pilote PDO IBM (PDO_IBM)</h1>
 
 <div class="partintro">

  <div class="section" id="pdo-ibm.intro">
   <h2 class="title">Introduction</h2>
   <p class="para">
    PDO_IBM est un driver qui implémente l&#039;interface <a href="book.pdo.php#intro.pdo" class="link">
    <code class="literal">PHP Data Objects</code> (PDO)</a> afin d&#039;activer l&#039;accès 
    à partir de PHP aux bases de données IBM.
   </p>
  </div>

  
  




<div class="section" id="ref.pdo-ibm.installation">
 <h2 class="title">Installation</h2>
 <p class="para">
  Pour compiler l&#039;extension PDO_IBM, le client DB2 v9.1 ou supérieur doit être
  installé sur le même système que PHP. Le client DB2 peut être téléchargé
  depuis le site d&#039;IBM de <a href="http://www.ibm.com/software/data/db2/ad" class="link external">&raquo;&nbsp;développement
   d&#039;applications</a>.
 </p>
 <blockquote class="note"><p><strong class="note">Note</strong>: 
  <strong>Note</strong><br />
   <p class="para">
    Le client DB2 v9.1 ou supérieur supporte les accès directs à DB2
    pour les systèmes Linux, UNIX et les serveurs Windows v8 et v9.1.
   </p>
   <p class="para">
    Le client DB2 v9.1 supporte également les accès à DB2 UDB pour i5
    et DB2 UDB pour les serveurs z/OS en utilisant le 
    <a href="http://www.ibm.com/software/data/db2/db2connect" class="link external">&raquo;&nbsp;produit de connexion DB2</a> payant.
   </p>
 </p></blockquote>
 <p class="para">
  PDO_IBM est une extension <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a>;
  il faut donc suivre les instructions de <a href="install.pecl.php" class="xref">Installation d'extensions PECL</a>
  pour installer l&#039;extension PDO_IBM. Exécutez la commande 
  <strong class="command">configure</strong> afin qu&#039;elle pointe vers le dossier 
  contenant les fichiers d&#039;en-têtes et les bibliothèques du
  client DB2 comme ceci :
  <div class="example-contents screen">
<div class="cdata"><pre>
 bash$ ./configure --with-pdo-ibm=/path/to/sqllib[,shared]
</pre></div>
  </div>
  La commande <strong class="command">configure</strong> utilise par défaut 
  la valeur de la variable d&#039;environnement <var class="envar">DB2DIR</var>.
 </p>
</div>



  
  


<div class="section" id="pdo-ibm.configuration">
 <h2 class="title">Configuration à l&#039;exécution</h2>
 <p class="simpara">Le comportement de ces fonctions est
affecté par la configuration dans le fichier <var class="filename">php.ini</var>.</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Options de configuration PDO_IBM</strong></caption>
   
    <thead>
     <tr>
      <th>Nom</th>
      <th>Défaut</th>
      <th>Modifiable</th>
      <th>Historique</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="ref.pdo-ibm.php#ini.pdo-ibm.i5-dbcs-alloc" class="link">pdo_ibm.i5_dbcs_alloc</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code>INI_SYSTEM</code></strong></td>
      <td>Ajouter dans PDO_IBM 1.5.0</td>
     </tr>

     <tr>
      <td><a href="ref.pdo-ibm.php#ini.pdo-ibm.i5-override-ccsid" class="link">pdo_ibm.i5_override_ccsid</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code>INI_SYSTEM</code></strong></td>
      <td>Ajouter dans PDO_IBM 1.5.0</td>
     </tr>

    </tbody>
   
  </table>

  Pour plus de détails sur les modes INI_*,
        reportez-vous à <a href="configuration.changes.modes.php" class="xref">O&ugrave; une directive de configuration peut &ecirc;tre modifi&eacute;e</a>.
</p>

<p class="para">Voici un éclaircissement sur
l&#039;utilisation des directives de configuration.</p>

 <p class="para">
  <dl>
   
    <dt id="ini.pdo-ibm.i5-dbcs-alloc">
     <code class="parameter">pdo_ibm.i5_dbcs_alloc</code>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
    </dt>
    <dd>
     <p class="para">
      Cette option affecte la stratégie d&#039;allocation de mémoire interne sur IBM i.
      Par défaut, cette option est 0. Lorsque cette option est définie, des
      tampons sont alloués avec une taille beaucoup plus grande, au cas où la
      base de données serait trompeuse sur la taille des caractères lors de la
      conversion entre les encodages. Cette option utilise six fois plus de
      mémoire pour les tampons (pour tenir compte des séquences UTF-8 les plus
      longues), mais peut être nécessaire si des données tronquées sont renvoyées.
      <ul class="itemizedlist">
       <li class="listitem">
        <p class="para">
         0 - La taille minimale des tampons est allouée.
        </p>
       </li>
       <li class="listitem">
        <p class="para">
         1 - Une plus grande taille des tampons est allouée.
        </p>
       </li>
      </ul>
     </p>
    </dd>
   
   
    <dt id="ini.pdo-ibm.i5-override-ccsid">
     <code class="parameter">pdo_ibm.i5_override_ccsid</code>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
    </dt>
    <dd>
     <p class="para">
      Le CCSID ASCII à utiliser pour la conversion de l&#039;EBCDIC sur IBM i. En
      définissant ceci à 1208, l&#039;on utilisera l&#039;UTF-8. Par défaut, c&#039;est 0, ce qui sélectionnera 
      le CCSID de travail ASCII par défaut.
     </p>
     <p class="para">
      Pour en savoir plus sur les CCSID sur IBM i, consulter la
      <a href="https://www.ibm.com/docs/en/i/7.5?topic=information-ccsid-reference" class="link external">&raquo;&nbsp;documentation IBM</a>.
     </p>
    </dd>
   
  </dl>
 </p>
</div>




 </div>

 
<h2>Sommaire</h2><ul class="chunklist chunklist_reference"><li><a href="ref.pdo-ibm.connection.php">PDO_IBM DSN</a> — Connexion aux bases de donn&eacute;es IBM</li></ul>
</div>
<?php manual_footer($setup); ?>