(PECL CUBRID >= 8.3.1)
cubrid_pconnect — Abrir una conexión persistente a un servidor CUBRID
$host
, int $port
, string $dbname
[, string $userid
[, string $passwd
]] )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'.
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.
El identificador de conexión, cuando el proceso tiene éxito.
FALSE
, cuando el proceso no tiene éxito.
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