<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.mysql.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.mysql-pconnect.php',
    1 => 'mysql_pconnect',
    2 => 'Abre una conexi&oacute;n persistente a un servidor MySQL',
  ),
  'up' => 
  array (
    0 => 'ref.mysql.php',
    1 => 'Funciones MySQL',
  ),
  'prev' => 
  array (
    0 => 'function.mysql-num-rows.php',
    1 => 'mysql_num_rows',
  ),
  'next' => 
  array (
    0 => 'function.mysql-ping.php',
    1 => 'mysql_ping',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/mysql/functions/mysql-pconnect.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mysql-pconnect" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mysql_pconnect</h1>
  <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">mysql_pconnect</span> &mdash; <span class="dc-title">Abre una conexión persistente a un servidor MySQL</span></p>

 </div>

 <div id="function.mysql-pconnect-refsynopsisdiv">
  <div class="warning"><strong class="warning">Advertencia</strong>
   <p class="para">Esta extensión
estaba obsoleta en PHP 5.5.0, y fue eliminada en PHP 7.0.0. En su lugar, se puede
utilizar la extensión <a href="book.mysqli.php" class="link">MySQLi</a> o la extensión
<a href="ref.pdo-mysql.php" class="link">PDO_MySQL</a>. Ver también
<a href="mysqlinfo.api.choosing.php" class="link">MySQL: elegir una API</a> de la guía.
Alternativas a esta función:</p>
   <ul class="simplelist">
    <li><span class="function"><a href="function.mysqli-connect.php" class="function">mysqli_connect()</a></span> con <code class="literal">p:</code> host prefix</li>
    <li><span class="methodname"><a href="pdo.construct.php" class="methodname">PDO::__construct()</a></span> con <strong><code><a href="pdo.constants.php#pdo.constants.attr-persistent">PDO::ATTR_PERSISTENT</a></code></strong> como una opción de controlador</li>
   </ul>
  </div>
 </div>

 <div class="refsect1 description" id="refsect1-function.mysql-pconnect-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mysql_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">$server</code><span class="initializer"> = ini_get(&quot;mysql.default_host&quot;)</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"> = ini_get(&quot;mysql.default_user&quot;)</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"> = ini_get(&quot;mysql.default_password&quot;)</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">$client_flags</code><span class="initializer"> = 0</span></span><br>): <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span></div>

  
  <p class="simpara">
   Establece una conexión persistente a un servidor MySQL.
  </p>
  
  <p class="simpara">
   <span class="function"><strong>mysql_pconnect()</strong></span> se parece mucho a
   <span class="function"><a href="function.mysql-connect.php" class="function">mysql_connect()</a></span> con dos grandes diferencias.
  </p>
  <p class="simpara">
   En primer lugar, cuando se conecta, la función primero intenta encontrar un
   enlace (persistente) que ya esté abierto con el mismo anfitrión,
   nombre de usuario y contraseña. Si se encuentra uno, se devolverá un identificador
   para él, en lugar de abrir una nueva conexión.
  </p>
  <p class="simpara">
   Segundo, la conexión al servidor SQL no será cerrada cuando
   la ejecución del script finalice. En su lugar, el enlace permanecerá
   abierto para su uso futuro (<span class="function"><a href="function.mysql-close.php" class="function">mysql_close()</a></span> no
   cerrará los enlaces establecidos mediante <span class="function"><strong>mysql_pconnect()</strong></span>).
  </p>
  <p class="simpara">
   Por eso a este tipo de enlace se le llama &#039;persistente&#039;.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mysql-pconnect-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">server</code></dt>
    <dd>
     <span class="simpara">
      El servidor de MySQL. También puede incluir un número de puerto. P.ej.
      &quot;nombre_anfitrión:puerto&quot; o una ruta a un socket local, p.ej. &quot;:/ruta/al/socket&quot; para
      el localhost.
     </span>
     <span class="simpara">
      Si la directiva de PHP <a href="mysql.configuration.php#ini.mysql.default-host" class="link">
      mysql.default_host</a> no se ha definido (predeterminado), entonces el
      valor por defecto es &#039;localhost:3306&#039;
     </span>
    </dd>
   
   
    <dt><code class="parameter">username</code></dt>
    <dd>
     <span class="simpara">
      El nombre de usuario. El valor por defecto es el nombre del usuario al que pertenece el
      proceso del servidor.
     </span>
    </dd>
   
   
    <dt><code class="parameter">password</code></dt>
    <dd>
     <span class="simpara">
      La contraseña. El valor por defecto es una contraseña vacia.
     </span>
    </dd>
   
   
    <dt><code class="parameter">client_flags</code></dt>
    <dd>
     <span class="simpara">
      El parámetro <code class="parameter">client_flags</code> puede ser una combinación
      de las siguientes constantes:
      128 (habilita el manejo de <code class="literal">LOAD DATA LOCAL</code>),
      <strong><code><a href="mysql.constants.php#constant.mysql-client-ssl">MYSQL_CLIENT_SSL</a></code></strong>,
      <strong><code><a href="mysql.constants.php#constant.mysql-client-compress">MYSQL_CLIENT_COMPRESS</a></code></strong>,
      <strong><code><a href="mysql.constants.php#constant.mysql-client-ignore-space">MYSQL_CLIENT_IGNORE_SPACE</a></code></strong> o
      <strong><code><a href="mysql.constants.php#constant.mysql-client-interactive">MYSQL_CLIENT_INTERACTIVE</a></code></strong>.
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mysql-pconnect-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">
   Devuelve un identificador de enlace persistente a MySQL en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> en
   caso de error.
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.mysql-pconnect-notes">
  <h3 class="title">Notas</h3>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    Tenga en cuenta que este tipo de enlaces solo funcionan si se está usando
    una versión de  módulo de PHP. Véase la
    sección <a href="features.persistent-connections.php" class="link">Conexiones
    persistentes a bases de datos</a> para más información.
   </span>
  </p></blockquote>
  <div class="warning"><strong class="warning">Advertencia</strong>
   <p class="simpara">
    El uso de conexiones persistentes puede requerir ajustar un poco las configuraciones
    de Apache y de MySQL para asegurarse de que no se excede el número de conexiones
    permitidas por MySQL.
   </p>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.mysql-pconnect-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.mysql-connect.php" class="function" rel="rdfs-seeAlso">mysql_connect()</a> - Abre una conexi&oacute;n al servidor MySQL</span></li>
   <li><a href="features.persistent-connections.php" class="link">Conexiones
    persistentes a bases de datos</a></li>
  </ul>
 </div>

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