cubrid_connect

(PECL CUBRID >= 8.3.1)

cubrid_connect — Abre uma conexão a um servidor CUBRID

Descrição

cubrid_connect(
    string $host,
    int $port,
    string $dbname,
    string $userid = ?,
    string $passwd = ?,
    bool $new_link = false
): resource

A função cubrid_connect() é usada para estabelecer o ambiente para conexão ao servidor usando o endereço do servidor, número da porta, nome do banco de dados, nome de usuário e senha. Se o nome de usuário e a senha não forem informados, a conexão "PUBLIC" será realizada por padrão.

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. Se não for informado, o valor padrão será “público”.

passwd

Senha do usuário. Se não for informado, o valor padrão será "".

new_link

Se uma segunda chamada for feita a cubrid_connect() com os mesmos argumentos, nenhuma nova conexão será estabelecida, mas em vez disso, o identificador da conexão já aberta será retornado. O parâmetro new_link modifica este comportamento e faz com que cubrid_connect() sempre abra uma nova conexão, mesmo que cubrid_connect() tenha sido chamada antes com os mesmos parâmetros.

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_connect("localhost", 33000, "demodb", "dba");

if (!$conn) {
    die('Erro de conexão ('. 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