cubrid_pconnect_with_url

Descripción

Establece una conexión persistente con un servidor CUBRID.

cubrid_pconnect_with_url() funciona de manera similar a la función cubrid_connect_with_url(), con dos diferencias principales.

En primer lugar, al establecer la conexión, la función intentará encontrar un enlace (persistente) ya abierto con el mismo host, en el mismo puerto, en la misma base de datos dbname y utilizando el mismo userid. Si se encuentra una conexión de este tipo, su identificador será devuelto en lugar de abrir una nueva conexión.

A continuación, la conexión al servidor CUBRID no se cerrará cuando finalice el script. En su lugar, la conexión permanecerá abierta para su uso futuro (la función cubrid_close() o la función cubrid_disconnect() no cerrarán la conexión establecida por la función cubrid_pconnect_with_url()).

Este tipo de enlace se denominaba anteriormente 'persistente'.

<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

• host : Un nombre de host o una dirección IP del servidor maestro de la base de datos
• db_name : Un nombre de base de datos
• db_user : Un nombre de usuario de la base de datos
• db_password : Una contraseña para el usuario de la base de datos
• autocommit : El modo auto-commit de la conexión a la base de datos
• alhosts : Especifica la información del broker del servidor, que será utilizado como punto de salida cuando no sea posible conectarse al servidor activo. Se pueden especificar varios brokers en este caso, y la conexión a los brokers se intentará en el orden de la configuración alhosts
• rctime : Un intervalo de tiempo para esperar antes de intentar una conexión con un broker cuando ocurre un error. Después de que ocurra un error, el sistema intentará conectarse a un broker especificado por althosts, terminará la transacción, y luego intentará conectarse al broker activo del servidor maestro de la base de datos. El valor por omisión es de 600 segundos.
• login_timeout : Valor del tiempo máximo de espera (unidad: milisegundo) para la identificación a la base de datos. Por omisión, este valor es 0, lo que significa que se espera indefinidamente.
• query_timeout : Valor del tiempo máximo de espera (unidad: milisegundo) para la ejecución de la consulta. Una vez alcanzado este valor, se envía un mensaje para cancelar la consulta enviada al servidor. El valor devuelto puede depender de la configuración de disconnect_on_query_timeout; incluso si el mensaje para cancelar la consulta ha sido enviado al servidor, la consulta puede tener éxito.
• disconnect_on_query_timeout : Configura un valor que determina si se debe devolver inmediatamente un error para las funciones ejecutadas después del tiempo máximo de espera. El valor por omisión es false.

Nota:

Los caracteres ? y : utilizados como identificadores en las URLs de conexión PHP no pueden ser incluidos en la contraseña. A continuación se muestra un ejemplo de contraseña inválida, ya que utiliza los caracteres "?:" en la URL de conexión.

$url = "CUBRID:localhost:33000:tdb:dba:12?:?login_timeout=100";

Las contraseñas que contienen el carácter ? o el carácter : pueden ser pasadas como argumento separado.

$url = "CUBRID:localhost:33000:tbd:::?login_timeout=100";

$conn = cubrid_pconnect_with_url ($url, "dba", "12?");

Si el nombre de usuario o la contraseña están vacíos, no se deben eliminar los ":"; a continuación se muestra un ejemplo:

$url = "CUBRID:localhost:33000:demodb:::";