oci_connect

Description

resource oci_connect ( string username, string password [, string db [, string charset [, int session_mode]]] )

oci_connect() retourne une ressource de connexion Oracle, nécessaire à la plupart des appels OCI. username est le nom d'utilisateur et password est le mot de passe utilisés durant l'identification. Le troisième paramètre db, optionnel, contient le nom de l'instance locale d'Oracle, ou le nom de l'entrée dans le fichier tnsnames.ora auquel vous voulez vous connecter. Si le troisième paramètre optionnel db n'est pas spécifié, PHP va utiliser la variable d'environnement ORACLE_SID (Oracle instance) ou TWO_TASK (tnsnames.ora) pour déterminer la base à laquelle se connecter.

Le paramètre session_mode est disponible depuis la version 1.1 et accepte les valeurs suivantes : OCI_DEFAULT, OCI_SYSOPER et OCI_SYSDBA. Si OCI_SYSOPER ou OCI_SYSDBA est spécifié oci_connect() tentera d'établir une connexion privilégiée en utilisant des crédances externes. Les connexions privilégiées sont désactivées par défaut. Pour les activer, vous devez définir oci8.privileged_connect à On.

Si vous utilisez un serveur Oracle version 9.2 et suivant, vous pouvez renseigner le paramètre charset, qui peut être utilisé dans la nouvelle connexion. Si vous utilisez un serveur Oracle inférieur à la version 9.2, ce paramètre sera ignoré et la variable d'environnement NLS_LANG sera utilisé à la place.

Exemple 1. Exemple avec oci_connect() <?php echo '<pre>'; $db = ''; $c1 = oci_connect("scott", "tiger", $db); $c2 = oci_connect("scott", "tiger", $db); function create_table($conn) {   $stmt = oci_parse($conn, "create table scott.hallo (test varchar2(64))");   oci_execute($stmt);   echo $conn . " created table\n\n"; } function drop_table($conn) {   $stmt = oci_parse($conn, "drop table scott.hallo");   oci_execute($stmt);   echo $conn . " dropped table\n\n"; } function insert_data($conn) {   $stmt = oci_parse($conn, "insert into scott.hallo             values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))");   oci_execute($stmt, OCI_DEFAULT);   echo $conn . " inserted hallo\n\n"; } function delete_data($conn) {   $stmt = oci_parse($conn, "delete from scott.hallo");   oci_execute($stmt, OCI_DEFAULT);   echo $conn . " deleted hallo\n\n"; } function commit($conn) {   oci_commit($conn);   echo $conn . " committed\n\n"; } function rollback($conn) {   oci_rollback($conn);   echo $conn . " rollback\n\n"; } function select_data($conn) {   $stmt = oci_parse($conn, "select * from scott.hallo");   oci_execute($stmt, OCI_DEFAULT);   echo $conn."----selecting\n\n";   while (oci_fetch($stmt)) {     echo $conn . " [" . oci_result($stmt, "TEST") . "]\n\n";   }   echo $conn . "----done\n\n"; } create_table($c1); insert_data($c1);   // Insertion d'une ligne via c1 insert_data($c2);   // Insertion d'une ligne via c2 select_data($c1);   // Résultat des insertions select_data($c2);    rollback($c1);      // Annulation sur c1 select_data($c1);   // Les deux insertions ont été annulées select_data($c2);    insert_data($c2);   // Insertion d'une ligne via c2 commit($c2);        // Validation via c2 select_data($c1);   // Le résultat de c2 est retourné delete_data($c1);   // Effacement de toute la table via c1 select_data($c1);   // Aucune ligne de trouvée select_data($c2);   // Aucune ligne de trouvée commit($c1);        // Validation via c1 select_data($c1);   // Aucune ligne de trouvée select_data($c2);   // Aucune ligne de trouvée drop_table($c1); echo '</pre>'; ?>

oci_connect() retourne FALSE si une erreur survient.

Voir aussi oci_pconnect(), oci_new_connect() et oci_close().