Función mysql_pconnect() de PHP

Definición y uso

La función mysql_pconnect() abre una conexión persistente con el servidor MySQL.

mysql_pconnect() y mysql_connect() son muy similares, pero tienen dos diferencias principales:

  1. Cuando se realiza la conexión, esta función intentará primero encontrar una conexión (persistente) abierta en el mismo host con el mismo nombre de usuario y contraseña, si se encuentra, devolverá el identificador de esta conexión sin abrir una nueva conexión.
  2. En segundo lugar, cuando el script se ejecuta, la conexión con el servidor SQL no se cerrará, esta conexión se mantendrá abierta para su uso futuro (mysql_close() no cerrará la conexión establecida por mysql_pconnect()).

Sintaxis

mysql_pconnect(server,user,pwd,clientflag)
Parámetros Descripción
server

Opcional. Especifica el servidor que se debe conectar.

Puede incluir el número de puerto, por ejemplo "hostname:port", o la ruta al socket local, por ejemplo para localhost ":/path/to/socket".

Si la instrucción mysql.default_host no está definida en PHP (situation por defecto), el valor predeterminado es 'localhost:3306'.

user Nombre de usuario opcional. El valor predeterminado es el nombre de usuario del propietario del proceso del servidor.
pwd Contraseña. El valor predeterminado es una contraseña vacía.
clientflag

Opcional.clientflags Los parámetros pueden ser una combinación de las siguientes constantes:

  • MYSQL_CLIENT_SSL - Usa encriptación SSL
  • MYSQL_CLIENT_COMPRESS - Usa protocolo de compresión
  • MYSQL_CLIENT_IGNORE_SPACE - Permite espacios después del nombre de la función
  • MYSQL_CLIENT_INTERACTIVE - Permite cerrar la conexión antes del tiempo de inactividad de interacción

Valor de retorno

Si tiene éxito, devuelve un identificador de conexión persistente MySQL, en caso de error devuelve FALSE.

Consejos y comentarios

Comentario:Parámetro opcional clientflag Disponible desde la versión PHP 4.3.0.

Consejo:Para crear una conexión no persistente, utilice mysql_connect() Función.

Ejemplo

<?php
$con = mysql_pconnect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('No se pudo conectar: ' . mysql_error());
  }
?>