(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_client_info — Establece la información del cliente
$connection, string $client_info): boolEstablece la información del cliente para el rastreo de Oracle.
La información del cliente se registra con la base de datos cuando ocurra el siguiente "viaje de ida y vuelta" desde PHP a la base de datos, normalemnte cuando una sentencia SQL es ejecutada.
La información del cliente puede ser consultado posteriormente desde una vista
de administración de la base de datos como V$SESSION.
El valor podría manterse entre conexiones persistentes.
connectionUn identificador de conexión de Oracle, devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().
client_infoLa cadena elegida por el usuario, hasta 64 bytes de longitud.
Devuelve true en caso de éxito o false en caso de error.
Ejemplo #1 Establecer la información del cliente
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Grabar la información del cliente
oci_set_client_info($c, 'My Application Version 2');
// Código que causa un viaje de ida y vuelta, por ejemplo una consulta:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>
// Mientras el script se esté ejecutando, el administrador puede ver la informaicón // del cliente: sqlplus system/welcome SQL> select client_info from v$session;
Nota: Requisito de versión de Oracle
Esta función esta disponible cuando PHP está vinculado con bibliotecas de Oracle Database de la versión 10g en adelante.
Con versiones antiguas de
OCI8 o de Oracle Database, se puede establecer la información del cliente usando el paquete
DBMS_APPLICATION_INFO de Oracle. Esto es menos eficiente que
utilizar oci_set_client_info().
Algunas, pero no todas, las funciones de OCI8 causan viajes de ida y vuelta. Estos podrían no ocurrir con las consultas cuando está habilitado el almacenamiento en caché de resultados.