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