oci_set_client_identifier
(PHP 5.3.2, PECL OCI8 >= 1.4.0)
oci_set_client_identifier — Sets the client identifier
Descrição
Sets the client identifier used by various database components to identify lightweight application users who authenticate as the same database user.
The client identifier is registered with the database when the next 'roundtrip' from PHP to the database occurs, typically when a SQL statement is executed.
The identifier can subsequently be queried from database administration views such as V$SESSION. It can be used with DBMS_MONITOR.CLIENT_ID_TRACE_ENABLE for tracing. It can be used for auditing.
The value may be retained across persistent connections.
Parâmetros
- connection
-
An Oracle connection identifier, returned by oci_connect(), oci_pconnect(), or oci_new_connect().
- client_identifier
-
User chosen string up to 64 bytes long.
Valor Retornado
Retorna TRUE em caso de sucesso ou FALSE em falhas.
Exemplos
Exemplo #1 Setting the client identifier to the application user
...
<?php
session_start();
$un = my_validate_session($_SESSION['username']);
$c = oci_connect('myschema', 'welcome', 'localhost/XE');
oci_set_client_identifier($c, $un);
$s = oci_parse($c, 'select mydata from mytable');
?>
...
Notas
Roundtrip Gotcha
Some but not all OCI8 functions cause roundtrips. Roundtrips to the database may not occur with queries when result caching is enabled.
Veja Também
- oci_set_module_name() - Sets the module name
- oci_set_action() - Sets the action name
- oci_set_client_info() - Sets the client information
oci_set_client_identifier
