php8.5
Home/ Manual/ oci8 / functions/ oci_set_client_info

oci_set_client_info

PHP function Edit on GitHub ✎

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

Sets the client information

Description

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

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.

Parameters

connection

Connection

client_info

User chosen string up to 64 bytes long.

Return Values

Success

Examples

Setting the client information

php
<?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);

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

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

Notes 10g Tip Caution

See Also

Source: reference/oci8/functions/oci-set-client-info.xml · from the official PHP manual (php/doc-en)