(PECL CUBRID >= 8.3.1)
cubrid_connect_with_url — Prepara o ambiente para conexão ao servidor CUBRID
$conn_url
,$userid
= ?,$passwd
= ?,$new_link
= false
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:::";
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.
Identificador da conexão em caso de sucesso, ou false
em caso de falha.
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);
}
?>