(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.
connection
Un identificador de conexión de Oracle, devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().
client_info
Cadena 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: 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.