<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.ibase.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'function.ibase-pconnect.php',
    1 => 'ibase_pconnect',
    2 => 'Abre uma conex&atilde;o persistente com um banco de dados InterBase',
  ),
  'up' => 
  array (
    0 => 'ref.ibase.php',
    1 => 'Fun&ccedil;&otilde;es para Firebird/InterBase',
  ),
  'prev' => 
  array (
    0 => 'function.ibase-param-info.php',
    1 => 'ibase_param_info',
  ),
  'next' => 
  array (
    0 => 'function.ibase-prepare.php',
    1 => 'ibase_prepare',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/ibase/functions/ibase-pconnect.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.ibase-pconnect" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">ibase_pconnect</h1>
  <p class="verinfo">(PHP 5, PHP 7 &lt; 7.4.0)</p><p class="refpurpose"><span class="refname">ibase_pconnect</span> &mdash; <span class="dc-title">Abre uma conexão persistente com um banco de dados InterBase</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.ibase-pconnect-description">
  <h3 class="title">Descrição</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>ibase_pconnect</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$database</code><span class="initializer"> = ?</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$username</code><span class="initializer"> = ?</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$password</code><span class="initializer"> = ?</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$charset</code><span class="initializer"> = ?</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$buffers</code><span class="initializer"> = ?</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$dialect</code><span class="initializer"> = ?</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$role</code><span class="initializer"> = ?</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$sync</code><span class="initializer"> = ?</span></span><br>): <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span></div>

  <p class="simpara">
   Abre uma conexão persistente com um banco de dados InterBase.
  </p>
  <p class="simpara">
   <span class="function"><strong>ibase_pconnect()</strong></span> age muito como
   <span class="function"><a href="function.ibase-connect.php" class="function">ibase_connect()</a></span> com duas diferenças principais.
  </p>
  <p class="simpara">
   Primeiro, ao conectar, a função tentará primeiro encontrar uma conexão
   (persistente) que já esteja aberta com os mesmos parâmetros. Se um for encontrada, um
   identificador para ela será retornado em vez de abrir uma nova conexão.
  </p>
  <p class="simpara">
   Segundo, a conexão com o servidor InterBase não será fechada quando a
   execução do script terminar. Em vez disso, ela permanecerá aberta para
   uso futuro (<span class="function"><a href="function.ibase-close.php" class="function">ibase_close()</a></span> não fechará conexões
   estabelecidas por <span class="function"><strong>ibase_pconnect()</strong></span>). Este tipo de conexão é
   portanto chamada de &#039;persistente&#039;.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.ibase-pconnect-parameters">
  <h3 class="title">Parâmetros</h3>
  <dl>
   
    <dt><code class="parameter">database</code></dt>
    <dd>
     <span class="simpara">
      O argumento <code class="parameter">database</code> tem que ser um caminho válido para
      o arquivo de banco de dados no servidor em que ele reside. Se o servidor não for local,
      ele deve ser prefixado com &#039;hostname:&#039; (TCP/IP), &#039;//hostname/&#039;
      (NetBEUI) ou &#039;hostname@&#039; (IPX/SPX), dependendo do protocolo de conexão
      usado.
     </span>
    </dd>
   
   
    <dt><code class="parameter">username</code></dt>
    <dd>
     <span class="simpara">
      O nome do usuário. Pode ser definido com a diretiva
      <code class="literal">ibase.default_user</code> <var class="filename">php.ini</var>.
     </span>
    </dd>
   
   
    <dt><code class="parameter">password</code></dt>
    <dd>
     <span class="simpara">
      A senha para <code class="parameter">username</code>. Pode ser definida com a
      <code class="literal">ibase.default_password</code> <var class="filename">php.ini</var> diretiva.
     </span>
    </dd>
   
   
    <dt><code class="parameter">charset</code></dt>
    <dd>
     <span class="simpara">
      <code class="parameter">charset</code> é o conjunto de caracteres padrão para o
      banco de dados.
     </span>
    </dd>
   
   
    <dt><code class="parameter">buffers</code></dt>
    <dd>
     <span class="simpara">
      <code class="parameter">buffers</code> é o número de buffers de banco de dados a
      alocar para o cache do lado do servidor. Se 0 ou omitido, o servidor escolhe
      seu próprio padrão.
     </span>
    </dd>
   
   
    <dt><code class="parameter">dialect</code></dt>
    <dd>
     <span class="simpara">
      <code class="parameter">dialect</code> seleciona o dialeto SQL padrão para qualquer
      declaração executada dentro de uma conexão, e ele assume como padrão o mais alto
      suportado pelas bibliotecas do cliente. Funcional apenas com o InterBase 6
      e superior.
     </span>
    </dd>
   
   
    <dt><code class="parameter">role</code></dt>
    <dd>
     <span class="simpara">
      Funcional apenas com InterBase 5 e superior.
     </span>
    </dd>
   
   
    <dt><code class="parameter">sync</code></dt>
    <dd>
     <span class="simpara">
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.ibase-pconnect-returnvalues">
  <h3 class="title">Valor Retornado</h3>
  <p class="simpara">
   Retorna um identificador de conexão do InterBase em caso de sucesso, ou <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> em caso de erro.
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.ibase-pconnect-seealso">
  <h3 class="title">Veja Também</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.ibase-close.php" class="function" rel="rdfs-seeAlso">ibase_close()</a> - Fecha uma conex&atilde;o com um banco de dados InterBase</span></li>
   <li><span class="function"><a href="function.ibase-connect.php" class="function" rel="rdfs-seeAlso">ibase_connect()</a> - Abre uma conex&atilde;o com um banco de dados</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>