(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_client_info — Define la información del cliente
Define la información del cliente para el trazado de Oracle.
La información del cliente se registra en la base de datos durante el próximo intercambio 'round-trip' desde PHP hacia la base de datos; típicamente, cuando se ejecuta una consulta SQL.
La información del cliente puede ser consultada posteriormente
desde la vista de administración de la base de datos V$SESSION.
El valor se conserva mediante el mecanismo de conexiones persistentes.
connectionUn identificador de conexión Oracle, devuelto por la función oci_connect(), oci_pconnect() o la función oci_new_connect().
client_infoCadena de caracteres de hasta 64 bytes de longitud.
Ejemplo #1 Define la información del cliente
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Registra la información del cliente
oci_set_client_info($c, 'My Application Version 2');
// Código que genera un intercambio (round-trip), por ejemplo, una consulta:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>// Durante la ejecución de este script, el administrador puede ver la información // del cliente: sqlplus system/welcome SQL> select client_info from v$session;
Nota: Requerido por la versión Oracle
Esta función está disponible si PHP está vinculado a partir de la versión 10g de la biblioteca de la base de datos Oracle.
Con versiones antiguas de OCI8 o bases de datos Oracle antiguas, la información del cliente
puede ser definida usando el paquete Oracle DBMS_APPLICATION_INFO.
Esto es menos eficiente que usar la función
oci_set_client_info().
Algunas funciones OCI8 requieren ida y vuelta con la base de datos. Estas ida y vuelta pueden ser evitadas al usar consultas cuyo resultado es almacenado en caché.