oci_set_client_info

(PHP 5 >= 5.3.2, PHP 7, PECL OCI8 >= 1.4.0)

oci_set_client_infoEstablece la información del cliente

Descripción

oci_set_client_info ( resource $connection , string $client_info ) : bool

Establece 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.

Parámetros

connection

Un identificador de conexión de Oracle, devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().

client_info

La cadena elegida por el usuario, hasta 64 bytes de longitud.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

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;

Notas

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.

Sugerencia

Rendimiento

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().

Precaución

Problema con los viajes de ida y vuelta

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.

Ver también