ocilogon

(PHP 3 >= 3.0.4, PHP 4, PHP 5)

ocilogon -- Etablit une connexion à un serveur Oracle

Description

resource ocilogon ( string username, string password [, string db [, string charset]] )

ocilogon() retourne un identifiant de connexion, nécessaire à la plupart des fonctions Oracle. Le nom d'utilisateur username et le mot de passe password seront utilisés pour l'identification. Le paramètre optionnel db peut contenir le nom local du serveur Oracle, ou bien son nom dans la table d'entrées tnsnames.ora à laquelle vous voulez vous connecter. Si le troisième paramètre n'est pas spécifié, PHP utilisera la variable d'environnement ORACLE_SID (instance Oracle) ou TWO_TASK (tnsnames.ora) pour déterminer la base à laquelle se connecter.

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.

Les connexions sont partagées, à l'intérieur d'une même page avec ocilogon(). Cela signifie que COMMIT et ROLLBACK s'appliquent à toutes les transactions commencées à l'intérieur d'une même page, même si vous avez créé de multiples connexions.

Les connexions sont partagées au niveau de la page, lorsque vous utilisez ocilogon(). Cela signifie que les validations et annulations s'appliquent à toutes les transactions de la page, même si vous avez créé de multiples connexions à un même serveur Oracle.

Cet exemple montre comment les connexions sont partagées :

Exemple 1. Exemple avec ocilogon()

<?php
echo '<html><pre>';
$db = '';

$c1 = ocilogon("scott","tiger",$db);
$c2 = ocilogon("scott","tiger",$db);

function
create_table($conn) {
$stmt = ociparse($conn,"create table scott.hallo (test varchar2(64))");
ociexecute($stmt);
echo
$conn." a créé une table\n\n";
}

function
drop_table($conn) {
$stmt = ociparse($conn,"drop table scott.hallo");
ociexecute($stmt);
echo
$conn." a effacé une table\n\n";
}

function
insert_data($conn) {
$stmt = ociparse($conn,"insert into scott.hallo
            values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))"
);
ociexecute($stmt,OCI_DEFAULT);
echo
$conn." a inséré dans hallo\n\n";
}

function
delete_data($conn) {
$stmt = ociparse($conn,"delete from scott.hallo");
ociexecute($stmt,OCI_DEFAULT);
echo
$conn." a effacé dans hallo\n\n";
}

function
commit($conn) {
ocicommit($conn);
echo
$conn." validé\n\n";
}

function
rollback($conn) {
ocirollback($conn);
echo
$conn." annulé\n\n";
}

function
select_data($conn) {
$stmt = ociparse($conn,"select * from scott.hallo");
ociexecute($stmt,OCI_DEFAULT);
echo
$conn."----selection\n\n";
while (
ocifetch($stmt)) {
   echo
$conn." <".ociresult($stmt,"TEST").">\n\n";
}
echo
$conn."----fin\n\n";
}

create_table($c1);
insert_data($c1);   // Insertion avec c1
insert_data($c2);   // Insertion avec c2

select_data($c1);   // Resultats 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 avec c2
commit($c2);        // Validation avec c2

select_data($c1);   // Le résultat de l'insertion via c2

delete_data($c1);   // Effacement de toutes les lignes avec c1
select_data($c1);   // Aucune ligne lue
select_data($c2);   // Aucune ligne lue
commit($c1);        // Validation avec c1

select_data($c1);   // Aucune ligne lue
select_data($c2);   // Aucune ligne lue

drop_table($c1);
echo
'</pre></html>';
?>

Note : Cette fonction a été renommée en oci_connect() pour PHP version 5.0.0 et plus récent. Pour la compatibilité ascendante, ocilogon() peut toujours être utilisée. Toutefois, elle est obsolète.

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:12