oci_set_client_info

Sets the client information

&reftitle.description; `bool` `oci_set_client_info` `resource` `connection` `string` `client_info`

Sets the client information for Oracle tracing.

The client information is registered with the database when the next 'round-trip' from PHP to the database occurs, typically when an SQL statement is executed.

The client information can subsequently be queried from database administration views such as `V$SESSION`.

The value may be retained across persistent connections.

&reftitle.parameters;

`connection`

- &oci.parameter.connection;

`client_info`

- User chosen string up to 64 bytes long.

&reftitle.returnvalues;

&return.success;

&reftitle.examples;

### Setting the client information

    <?php

    $c = oci_connect('hr', 'welcome', 'localhost/XE');

    // Record the client information
    oci_set_client_info($c, 'My Application Version 2');

    // Code that causes a round-trip, for example a query:
    $s = oci_parse($c, 'select * from dual');
    oci_execute($s);
    oci_fetch_all($s, $res);

    sleep(30);

    ?>

    // While the script is running, the administrator can see the client
    // information:

    sqlplus system/welcome
    SQL> select client_info from v$session;

&reftitle.notes; &oci.availability.note.10g; &oci.clientinfo.tip; &oci.roundtrip.caution;
&reftitle.seealso;

- `oci_set_module_name`
- `oci_set_action`
- `oci_set_client_identifier`
- `oci_set_db_operation`