array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.cubrid-pconnect.php', 1 => 'cubrid_pconnect', 2 => 'Abre uma conexão persistente a um servidor CUBRID', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'Funções de CUBRID', ), 'prev' => array ( 0 => 'function.cubrid-num-rows.php', 1 => 'cubrid_num_rows', ), 'next' => array ( 0 => 'function.cubrid-pconnect-with-url.php', 1 => 'cubrid_pconnect_with_url', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/cubrid/functions/cubrid-pconnect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Exemplo #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