Documentación offline PHP master

oci_set_client_info

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

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ón oci_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