cubrid_pconnect

(PECL CUBRID >= 8.3.1)

cubrid_pconnect — Abre uma conexão persistente a um servidor CUBRID

Descrição

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

Estabelece uma conexão persistente a um servidor CUBRID.

cubrid_pconnect() funciona de forma muito similar a cubrid_connect() com duas diferenças principais.

Primeiro, ao conectar, a função tentará primeiro encontrar uma conexão (persistente) já aberta com o mesmo servidor, porta, nome do banco de dados e ID do usuário. Se for encontrada, um identificador será retornado em vez de abrir uma nova conexão.

Segundo, a conexão com o servidor SQL não será encerrada quando a execução do script terminar. Em vez disso, a conexão permanecerá aberta para uso futuro (cubrid_close() ou cubrid_disconnect() não fecharão conexões estabelecidas por cubrid_pconnect()).

Este tipo de conexão é, portanto, denominada 'persistente'.

Parâmetros

host

Nome de servidor ou endereço IP do servidor CUBRID CAS.

port

Número da porta do servidor CUBRID CAS (BROKER_PORT configurado em $CUBRID/conf/cubrid_broker.conf).

dbname

Nome do banco de dados.

userid

Nome de usuário do banco de dados.

passwd

Senha do usuário.

Valor Retornado

Identificador da conexão em caso de sucesso, ou false em caso de falha.

Exemplos

Example #1 Exemplo de cubrid_connect()

<?php
printf("%-34s %s\n", "Versão do CUBRID PHP:", 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("%-34s %s\n", $param_name, $param_value);
}

printf("\n");

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

printf("%-34s %s\n", "Informação do Servidor:", $server_info);
printf("%-34s %s\n", "Informação do Cliente:", $client_info);

printf("\n");

$charset = cubrid_get_charset($conn);

printf("%-34s %s\n", "Conjunto de caracteres do CUBRID:", $charset);

cubrid_disconnect($conn);
?>

O exemplo acima produzirá:

Versão do CUBRID PHP:              9.1.0.0001

PARAM_ISOLATION_LEVEL              3
LOCK_TIMEOUT                       -1
MAX_STRING_LENGTH                  1073741823
PARAM_AUTO_COMMIT                  1

Informação do Servidor:            9.1.0.0212
Informação do Cliente:             9.1.0

Conjunto de caracteres do CUBRID:  iso8859-1

Veja Também