oci_set_client_identifier
oci_set_edition
Fonctions OCI8
PHP Manual

# oci_set_client_info

(PHP 5.3.2, PECL OCI8 >= 1.4.0)

oci_set_client_info — Définit l'information concernant le client

### Description

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

Définit l'information concernant le client pour un traçage Oracle.

L'information du client est enregistré avec la base de données lorsque le prochain 'roundtrip' depuis PHP vers la base de données survient ; typiquement, lorsqu'une requête SQL est exécutée.

L'information du client peut par la suite être interrogée depuis la vue d'administration de la base de données V$SESSION.

La valeur sera conservée via le mécanisme des connexions persistantes.

### Liste de paramètres

`connection`

  Un identifiant de connexion Oracle, retourné par la fonction oci_connect(), oci_pconnect() ou la fonction oci_new_connect().

`client_info`

  Chaîne utilisateur jusqu'à 64 octets de long.

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

### Exemples

Exemple #1 Définit l'information sur le client

`<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Enregistre l'information sur le client
oci_set_client_info($c, 'My Application Version 2');
// On exécute un code permettant un aller-retour vers la base de données,
// par exemple, une requête :
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>`

    // Pendant l'exécution de ce script, l'administrateur peut voir les informations
    // du client :

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

### Notes

> Note: Requis par la version Oracle

> Cette fonction est disponible si PHP est lié à partir de la version de la bibliothèque de la base de données Oracle .

Astuce

# Performance

Avec les anciennes version OCI8 ou les anciennes bases de données Oracle, l'information quant au client peut être défini en utilisant le paquet Oracle DBMS_APPLICATION_INFO. Ceci est moins efficace que d'utiliser la fonction oci_set_client_info().

Attention

# Allé-Retour

Quelques fonctions OCI8 nécessitent des allé-retours avec la base de données. Ces allé-retours peuvent être évités lors de l'utilisation de requêtes dont le résultat est mis en cache.

### Voir aussi

- oci_set_module_name() - Définit le nom du module
- oci_set_action() - Définit le nom de l'action
- oci_set_client_identifier() - Définit l'identifiant du client

oci_set_client_identifier
oci_set_edition
Fonctions OCI8
PHP Manual