Manuel PHP
Précédent |  | Suivant

# oci_connect

(PHP 5)

oci_connect -- Etablit une connexion avec un serveur Oracle

## 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.

> Note : Si vous utilisez PHP avec le client Instant Oracle, vous pouvez utiliser la méthode de nommage facile de connexion tel que décrit ici : http://download-west.oracle.com/docs/cd/B12037_01/network.101/b10775/naming.htm#i498306. Basiquement, cela signifie que vous pouvez spécifier "//db_host[:port]/database_name" en tant que nom de base de données. ais, si vous voulez utiliser l'ancienne méthode de nommage, vous devez définir soit `ORACLE_HOME`, soit `TNS_ADMIN`.

> Note : Le second appel ainsi que les suivants à la fonction oci_connect() avec les mêmes paramètres retournera le gestionnaire de connexion retourné lors du premier appel. Cela signifie que les requêtes envoyées sur un gestionnaire seront également envoyées aux autres gestionnaires, car c'est le même gestionnaire. Ce comportement est démontré dans l'exemple 1 ci-dessous. Si vous avez besoin de deux gestionnaires isolés transactionnellement, vous devez utiliser la fonction oci_new_connect() à la place.

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ée à 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.

> Note : Dans les versions de PHP antérieures à la version 5.0.0, vous devez utiliser la fonction ocilogon(). Cet ancien nom est toujours utilisable : un alias a été fait vers la fonction oci_connect(), pour assurer la compatibilité ascendante. Toutefois, il est recommandé de ne plus l'utiliser.

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

Précédent | Sommaire | Suivant
oci_commit | Niveau supérieur | oci_define_by_name