oci_set_client_info
En esta página
oci_set_client_info
Define la información del cliente
Descripción#
oci_set_client_info(resource $connection, string $client_info): bool
```php
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.
## Parámetros
`connection`
Un identificador de conexión Oracle, devuelto por la función `oci_connect`, `oci_pconnect` o la función `oci_new_connect`.
`client_info`
Cadena de caracteres de hasta 64 bytes de longitud.
## Valores devueltos
Esta función retorna `true` en caso de éxito o `false` si ocurre un error.
## Ejemplos
Define la información del cliente
```php
// 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;
Notas#
[!NOTE] 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.
[!TIP] 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ónoci_set_client_info.[!CAUTION] 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é.
Véase también#
oci_set_module_name, oci_set_action, oci_set_client_identifier, oci_set_db_operation