(PECL CUBRID >= 8.3.1)
cubrid_connect_with_url — Establecer el entorno para la conexión al servidor de CUBRID
$conn_url
[, string $userid
[, string $passwd
[, bool $new_link = false
]]] )La función cubrid_connect_with_url() se usa para establecer el entorno de conexión a su servidor usando la información de conexión pasada con un argumento de cadena de url. Si la característica HA está habilitada en CUBRID, se debe especificar la información de conexión del servidor de emergencia, el cual se usa para la recuperación de fallos cuando sucede uno, en el argumento de cadena de url de esta función. Si el nombre de usuario y la contraseña no se dan se realizará la conexión "PUBLIC" por omisión.
<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:
? y :, que son usados como identificadores en el URL de conexión de PHP, no pueden ser incluidos en la contraseña. El siguiente es un ejemplo de una contraseña que no es válida para usarla como URL de conexión ya que contiene "?:".
$url = "CUBRID:localhost:33000:tdb:dba:12?:?autocommit=off";
Las contraseñas que contengan ? o : se pueden pasar como un parámetro aparte.
$url = "CUBRID:localhost:33000:tbd:::?autocommit=off";
$conn = cubrid_connect_with_url($url, "dba", "12?");
conn_url
Una cadena de caracteres que contiene la información de conexión al servidor.
userid
El nombre de usuario de la base de datos.
passwd
La contraseña del usuario.
new_link
Si se hace una segunda llamada a
cubrid_connect_with_url() con los mismos argumentos,
no se establecerá una nueva conexión, en su lugar, se devolverá el identificador
de conexión de la conexión ya abierta. El
parámetro new_link modifica este comportamiento y
hace que cubrid_connect_with_url() abra siempre una nueva
conexión, incluso si cubrid_connect_with_url() fue
llamada antes con los mismos parámetros.
El identificador de conexión, cuando el proceso tiene éxito.
FALSE, cuando el proceso no tiene éxito.
Ejemplo #1 Ejemplo de cubrid_connect_with_url(), url sin propiedades
<?php
$conn_url = "CUBRID:localhost:33000:demodb:public:123456";
$con = cubrid_connect_with_url($conn_url);
if ($con) {
echo "Se conectó con éxito";
$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);
}
?>
Ejemplo #2 Ejemplo de cubrid_connect_with_url(), url con propiedades
<?php
$conn_url = "CUBRID:127.0.0.1:33000:demodb:public:123456:?althost=10.34.63.132:33088&rctime=100"
$con = cubrid_connect_with_url ($conn_url);
if ($con) {
echo "Se conectó con éxito";
$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);
}
?>