cubrid_pconnect

(PECL CUBRID >= 8.3.1)

cubrid_pconnect — Abrir una conexión persistente a un servidor CUBRID

Descripción

cubrid_pconnect(
    string $host,
    int $port,
    string $dbname,
    string $userid = ?,
    string $passwd = ?
): resource

Establece una conexión persistente a un servidor CUBRID.

cubrid_pconnect() actúa de manera muy similar a cubrid_connect() con dos diferencias importantes.

Primera, al conectar, la función intenta encontrar un enlace (persistente) que ya estuviera abierto con el mismo host, puerto, nombre de base de datos e id de usuario. Si se encuentra uno, se devolverá un identificador para él en lugar de abrir una nueva conexión.

Segunda, la conexión al servidor SQL no se cerrará cuando la ejecución del script termine. En su lugar, el enlace permanece abierto para usos futuros (cubrid_close() o cubrid_disconnect() no cerrarán enlaces establecido por cubrid_pconnect_with_url()).

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

Parámetros

host: Nombre del host o dirección IP del servidor CAS de CUBRID.
port: Número de puerto del servidor CAS de CUBRID (BROKER_PORT configurado en $CUBRID/conf/cubrid_broker.conf).
dbname: Nombre de la base de datos.
userid: Nombre de usuario para la base de datos.
passwd: Contraseña del usuario.

Valores devueltos

El identificador de conexión, cuando el proceso tiene éxito.

false, cuando el proceso no tiene éxito.

Ejemplos

Ejemplo #1 Ejemplo de cubrid_pconnect()

<?php
printf("%-30s %s\n", "CUBRID PHP Version:", cubrid_version());

printf("\n");

$conn = cubrid_pconnect("localhost", 33000, "demodb", "dba");

if (!$conn) {
    die('Connect Error ('. cubrid_error_code() .')' . cubrid_error_msg());
}

$db_params = cubrid_get_db_parameter($conn);

while (list($param_name, $param_value) = each($db_params)) {
    printf("%-30s %s\n", $param_name, $param_value);
}

printf("\n");

$server_info = cubrid_get_server_info($conn);
$client_info = cubrid_get_client_info();

printf("%-30s %s\n", "Server Info:", $server_info);
printf("%-30s %s\n", "Client Info:", $client_info);

printf("\n");

$charset = cubrid_get_charset($conn);

printf("%-30s %s\n", "CUBRID Charset:", $charset);

cubrid_disconnect($conn);
?>

El resultado del ejemplo sería:

CUBRID PHP Version:            9.1.0.0001

PARAM_ISOLATION_LEVEL          3
LOCK_TIMEOUT                   -1
MAX_STRING_LENGTH              1073741823
PARAM_AUTO_COMMIT              1

Server Info:                   9.1.0.0212
Client Info:                   9.1.0

CUBRID Charset:                iso8859-1

Ver también

cubrid_connect() - Abrir una conexión al servidor CUBRID
cubrid_connect_with_url() - Establecer el entorno para la conexión al servidor de CUBRID
cubrid_pconnect_with_url() - Abrir una conexión persistente al servidor CUBRID
cubrid_disconnect() - Cerrar una conexión a una base de datos
cubrid_close() - Cerrar la conexión de CUBRID

add a note

User Contributed Notes

There are no user contributed notes for this page.