<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-ibm.php',
    1 => 'Driver PDO da IBM',
    2 => 'Driver PDO da IBM (PDO_IBM)',
  ),
  'up' => 
  array (
    0 => 'pdo.drivers.php',
    1 => 'Drivers do 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' => 'pt_BR',
    '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">Driver PDO da IBM (PDO_IBM)</h1>
  
  <div class="partintro">

   <div class="section" id="pdo-ibm.intro">
    <h2 class="title">Introdução</h2>
    <p class="para">
     PDO_IBM é um driver que implementa a interface aos <a href="book.pdo.php#intro.pdo" class="link"> Objetos
     de Dados PHP (PDO)</a> para permitir acesso do PHP a bancos de dados IBM.
    </p>
   </div>

   
   

<div class="section" id="ref.pdo-ibm.installation">
 <h2 class="title">Instalação</h2>
 <p class="para">
  Para construir a extensão PDO_IBM, o DB2 Client v9.1 ou posterior deve ser
  instalado no mesmo sistema que o PHP. O DB2 Client pode ser obtido
  do <a href="http://www.ibm.com/software/data/db2/ad" class="link external">&raquo;&nbsp;Site de Desenvolvimento de
  Aplicativos</a> da IBM.
 </p>
 <blockquote class="note"><p><strong class="note">Nota</strong>: 
  <strong>Notas</strong><br />
   <p class="para">
    O DB2 Client v9.1 ou posterior suporta acesso direto aos servidores DB2 para Linux,
    UNIX e Windows v8 e v9.1.
   </p>
   <p class="para">
    O DB2 Client v9.1 também suporta acesso a servidores DB2 UDB para i5 e DB2 UDB
    para z/OS usando o <a href="http://www.ibm.com/software/data/db2/db2connect" class="link external">&raquo;&nbsp;produto DB2 Connect</a>
    adquirido separadamente.
   </p>
 </p></blockquote>
 <p class="para">
  PDO_IBM é uma extensão <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a>, portanto siga as instruções em
  <a href="install.pecl.php" class="xref">Instala&ccedil;&atilde;o das extens&otilde;es PECL</a> para instalar a extensão PDO_IBM.
  Execute o comando <strong class="command">configure</strong> para apontar o caminho dos
  arquivos de cabeçalho e bibliotecas do DB2 Client, conforme a seguir:
  <div class="example-contents screen">
<div class="cdata"><pre>
bash$ ./configure --with-pdo-ibm=/caminho/para/sqllib[,shared]
</pre></div>
  </div>
  O comando <strong class="command">configure</strong> tem como padrão o valor da
  variável de ambiente <var class="envar">DB2DIR</var>.
 </p>
</div>



   
   

<div class="section" id="pdo-ibm.configuration">
 <h2 class="title">Configurações em Execução</h2>
 <p class="simpara">
O comportamento destas funções é afetado pelas configurações do <var class="filename">php.ini</var>.
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Opções de Configuração do PDO_IBM</strong></caption>
   
    <thead>
     <tr>
      <th>Nome</th>
      <th>Padrão</th>
      <th>Modificável</th>
      <th>Registro de Alterações</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><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td>Adicionado no 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><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td>Adicionado no PDO_IBM 1.5.0</td>
     </tr>

    </tbody>
   
  </table>

  Para mais detalhes e definições dos modos
INI_*, consulte os <a href="configuration.changes.modes.php" class="xref">Onde uma configura&ccedil;&atilde;o deve ser definida</a>.
</p>

<p class="para">Aqui está uma breve explicação das
diretivas de configuração.</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">
      Esta opção afeta a estratégia de alocação de buffer interno no IBM i.
      Por padrão, esta opção é 0. Quando esta opção é definida, os buffers são
      alocados com um tamanho muito maior, caso o banco de dados se engane
      sobre o tamanho dos caracteres ao converter entre codificações. Esta opção usa
      seis vezes mais memória para buffers (para considerar as maiores sequências
      UTF-8 possíveis), mas pode ser necessária se forem retornados dados truncados.
      <ul class="itemizedlist">
       <li class="listitem">
        <p class="para">
         0 - Buffers de tamanho mínimo são alocados.
        </p>
       </li>
       <li class="listitem">
        <p class="para">
         1 - Buffers de tamanho maior são alocados.
        </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">
      O CCSID ASCII a ser usado para conversão de EBCDIC no IBM i. Definir como
      1208 usará UTF-8. Por padrão, é 0, que selecionará o CCSID
      da tarefa ASCII padrão.
     </p>
     <p class="para">
      Para saber mais sobre CCSIDs no IBM i, consulte a
      <a href="https://www.ibm.com/docs/en/i/7.5?topic=information-ccsid-reference" class="link external">&raquo;&nbsp;documentação da IBM</a>.
     </p>
    </dd>
   
  </dl>
 </p>
</div>




  </div>

  

 <h2>Índice</h2><ul class="chunklist chunklist_reference"><li><a href="ref.pdo-ibm.connection.php">PDO_IBM DSN</a> — Conectando-se a bancos de dados IBM</li></ul>
</div>
<?php manual_footer($setup); ?>