(PHP 4, PHP 5)
mysql_pconnect — Abre una conexión persistente a un servidor MySQL
Alternativas sugeridas
El uso de esta función está desaconsejado. En su lugar debería usarse la extensión MySQLi o PDO_MySQL. Véase también la guía MySQL: escoger una API y las P+F relacionadas para más información. Las alternativas a esta función incluyen:
- mysqli_connect() con p: host prefix
- PDO::__construct() con
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'.
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
.
Devuelve un identificador de enlace persistente a MySQL en caso de éxito o FALSE
en
caso de error.
Versión | Descripción |
---|---|
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.