mysql_pconnect

    (PHP 4, PHP 5)

    mysql_pconnect — Abre una conexión persistente a un servidor MySQL

    Advertencia

    Esta extensión fue declarada obsoleta en PHP 5.5.0 y eliminada en PHP 7.0.0. En su lugar debería utilzarse las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API. Las alternativas a esta función son:

    Descripción

    mysql_pconnect(
        string$server = ini_get("mysql.default_host"),
        string$username = ini_get("mysql.default_user"),
        string$password = ini_get("mysql.default_password"),
        int$client_flags = 0
    ): resource

    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

    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.

    Advertencia

    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.

    Ver también

    To Top