(PHP 4, PHP 5)
mysql_pconnect — Abre una conexión persistente a un servidor MySQL
Esta extensión está obsoleta a partir de PHP 5.5.0, y será eliminada en el futuro. En su lugar, deberían usarse las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API y P+F relacionadas para más información. Las alternativas a esta función incluyen:
PDO::ATTR_PERSISTENT como una opción de controlador$server = ini_get("mysql.default_host")
[, string $username = ini_get("mysql.default_user")
[, string $password = ini_get("mysql.default_password")
[, int $client_flags = 0
]]]] )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'.
serverEl 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'
usernameEl nombre de usuario. El valor por defecto es el nombre del usuario al que pertenece el proceso del servidor.
passwordLa 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.
Devuelve un identificador de enlace persistente a MySQL en caso de éxito o FALSE en
caso de error.
| Versión | Descripción |
|---|---|
| 5.5.0 |
Esta función generará un error de nivel
E_DEPRECATED.
|
| 4.3.0 |
Se añadió el parámetro client_flags.
|
Nota:
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.
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.
Nota:
En caso de error, se puede suprimir el mensaje de error anteponiendo una @ al nombre de la función.