array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.cubrid-connect-with-url.php', 1 => 'cubrid_connect_with_url', 2 => 'Prepara o ambiente para conexão ao servidor CUBRID', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'Funções de CUBRID', ), 'prev' => array ( 0 => 'function.cubrid-connect.php', 1 => 'cubrid_connect', ), 'next' => array ( 0 => 'function.cubrid-current-oid.php', 1 => 'cubrid_current_oid', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/cubrid/functions/cubrid-connect-with-url.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

cubrid_connect_with_url

(PECL CUBRID >= 8.3.1)

cubrid_connect_with_url — Prepara o ambiente para conexão ao servidor CUBRID

Descrição

cubrid_connect_with_url(
    string $conn_url,
    string $userid = ?,
    string $passwd = ?,
    bool $new_link = false
): resource

A função cubrid_connect_with_url() é usada para estabelecer o ambiente para conexão ao servidor usando informação passada por um argumento URL no formato string. Se o recurso HA estiver habilitado no CUBRID, é necessário especificar a informação de conexão do servidor reserva, que é usado em caso de falha, na string do argumento de URL desta função. Se o usuário e a senha não forem informados, a conexão "PUBLIC" será realizada por padrão.

<url> ::= CUBRID:<host>:<db_name>:<db_user>:<db_password>:[?<properties>]

<properties> ::= <property> [&<property>]

<properties> ::= alhosts=<alternative_hosts>[ &rctime=<time>]

<properties> ::= login_timeout=<milli_sec>

<properties> ::= query_timeout=<milli_sec>

<properties> ::= disconnect_on_query_timeout=true|false

<alternative_hosts> ::= <standby_broker1_host>:<port> [,<standby_broker2_host>:<port>]

<host> := HOSTNAME | IP_ADDR

<time> := SECOND

<milli_sec> := MILLI SECOND

Nota: ? e : são usados como identificadores na URL de conexão do PHP e não podem ser incluídos na senha. O exemplo a seguir é uma senha inválida para URL de conexão por conter "?:". $url = "CUBRID:localhost:33000:tdb:dba:12?:?login_timeout=100"; Senhas que contêm ? ou : podem ser passadas como parâmetro separado. $url = "CUBRID:localhost:33000:tbd:::?login_timeout=100"; $conn = cubrid_connect_with_url($url, "dba", "12?"); Se o usuário ou a senha estiverem vazios, o caractere ":" não pode ser omitido, veja este exemplo: $url = "CUBRID:localhost:33000:demodb:::";

Parâmetros

conn_url
Uma string contendo informação de conexão ao servidor.
userid
Nome de usuário para o banco de dados.
passwd
Senha do usuário.
new_link
Se uma segunda chamada for feita a cubrid_connect_with_url() 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_with_url() sempre abra uma nova conexão, mesmo que cubrid_connect_with_url() 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

Exemplo #1 Exemplo de cubrid_connect_with_url() e URL sem propriedades

<?php
$conn_url = "CUBRID:localhost:33000:demodb:dba::";
$con = cubrid_connect_with_url($conn_url);

if ($con) {
echo "conectado com sucesso";
cubrid_execute($con, "create table person(id int,name char(16))");
$req =cubrid_execute($con, "insert into person values(1,'James')");

if ($req) {
cubrid_close_request($req);
cubrid_commit($con);
} else {
cubrid_rollback($con);
}
cubrid_disconnect($con);
}
?>

Exemplo #2 Exemplo de cubrid_connect_with_url() e URL com propriedades

<?php
$conn_url = "CUBRID:127.0.0.1:33000:demodb:dba::?login_timeout=100";
$con = cubrid_connect_with_url ($conn_url);

if ($con) {
echo "conectado com sucesso";
cubrid_execute($con, "create table person(id int,name char(16))");
$req =cubrid_execute($con, "insert into person values(1,'James')");

if ($req) {
cubrid_close_request($req);
cubrid_commit($con);
} else {
cubrid_rollback($con);
}
cubrid_disconnect($con);
}
?>

Veja Também