Documentación offline PHP master

mysql_pconnect

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

mysql_pconnect

Abre una conexión persistente a un servidor MySQL

[!WARNING] 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 MySQLi o la extensión PDO_MySQL. Ver también MySQL: elegir una API de la guía. Alternativas a esta función:

mysqli_connect

con el prefijo de host

p:

PDO::__construct

con

PDO::ATTR_PERSISTENT

como una opción de controlador

Descripción#

php mysql_pconnect([string $server], [string $username], [string $password], [int $client_flags]): resourcephp

Establece una conexión persistente a un servidor MySQL.

mysql_pconnect se parece mucho a mysql_connect con dos grandes diferencias.

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.

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 (mysql_close no cerrará los enlaces establecidos mediante mysql_pconnect).

Por eso a este tipo de enlace se le llama 'persistente'.

Parámetros#

server
El servidor de MySQL. También puede incluir un número de puerto. P.ej. "nombre_anfitrión:puerto" o una ruta a un socket local, p.ej. ":/ruta/al/socket" para el localhost.

Si la directiva de PHP mysql.default_host no se ha definido (predeterminado), entonces el valor por defecto es 'localhost:3306'

username
El nombre de usuario. El valor por defecto es el nombre del usuario al que pertenece el proceso del servidor.

password
La contraseña. El valor por defecto es una contraseña vacia.

client_flags
El parámetro client_flags puede ser una combinación de las siguientes constantes: 128 (habilita el manejo de LOAD DATA LOCAL), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE o MYSQL_CLIENT_INTERACTIVE.

Valores devueltos#

Devuelve un identificador de enlace persistente a MySQL en caso de éxito o false en caso de error.

Notas#

[!NOTE] 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 Conexiones persistentes a bases de datos para más información.

[!WARNING] 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.

Véase también#

mysql_connect

Conexiones persistentes a bases de datos