Manuel PHP

Fonctions OCI8
PHP Manual

oci_connect

(PHP 5, PECL oci8 >= 1.1.0)

oci_connect — Établit une connexion avec un serveur Oracle

Description

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

Retourne une ressource de connexion Oracle, nécessaire à la plupart des appels OCI.

Liste de paramètres

username

Le nom d'utilisateur Oracle.

password

Le mot de passe de l'utilisateur.

db

Ce paramètre 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.

S'il 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.

charset

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.

session_mode

Ce paramètre 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 droits externes. Les connexions privilégiées sont désactivées par défaut. Pour les activer, vous devez définir oci8.privileged_connect à On.

Valeurs de retour

Retourne un identifiant de connexion ou FALSE si une erreur survient.

Exemples

Exemple #1 Exemple avec oci_connect()

  1. <?php
  2. echo "<pre>";  
  3. $db = "";  
  4.  
  5. $c1 = oci_connect("scott", "tiger", $db);  
  6. $c2 = oci_connect("scott", "tiger", $db);  
  7.  
  8. function create_table($conn)  
  9. {  
  10. $stmt = oci_parse($conn, "create table scott.hallo (test varchar2(64))");  
  11. oci_execute($stmt);  
  12. echo $conn . " created table\n\n";  
  13. }  
  14.  
  15. function drop_table($conn)  
  16. {  
  17. $stmt = oci_parse($conn, "drop table scott.hallo");  
  18. oci_execute($stmt);  
  19. echo $conn . " dropped table\n\n";  
  20. }  
  21.  
  22. function insert_data($conn)  
  23. {  
  24. $stmt = oci_parse($conn, "insert into scott.hallo
  25.          values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))");  
  26. oci_execute($stmt, OCI_DEFAULT);  
  27. echo $conn . " inserted hallo\n\n";  
  28. }  
  29.  
  30. function delete_data($conn)  
  31. {  
  32. $stmt = oci_parse($conn, "delete from scott.hallo");  
  33. oci_execute($stmt, OCI_DEFAULT);  
  34. echo $conn . " deleted hallo\n\n";  
  35. }  
  36.  
  37. function commit($conn)  
  38. {  
  39. oci_commit($conn);  
  40. echo $conn . " committed\n\n";  
  41. }  
  42.  
  43. function rollback($conn)  
  44. {  
  45. oci_rollback($conn);  
  46. echo $conn . " rollback\n\n";  
  47. }  
  48.  
  49. function select_data($conn)  
  50. {  
  51. $stmt = oci_parse($conn, "select * from scott.hallo");  
  52. oci_execute($stmt, OCI_DEFAULT);  
  53. echo $conn."----selecting\n\n";  
  54. while (oci_fetch($stmt)) { 
  55.    echo $conn . " [" . oci_result($stmt, "TEST") . "]\n\n";  
  56. }  
  57. echo $conn . "----done\n\n";  
  58. }  
  59.  
  60. create_table($c1);  
  61. insert_data($c1); // Insertion d'une ligne via c1
  62. insert_data($c2); // Insertion d'une ligne via c2
  63.  
  64. select_data($c1); // Résultat des insertions
  65. select_data($c2);  
  66.  
  67. rollback($c1);   // Annulation sur c1
  68.  
  69. select_data($c1); // Les deux insertions ont été annulées
  70. select_data($c2);  
  71.  
  72. insert_data($c2); // Insertion d'une ligne via c2
  73. commit($c2);      // Validation via c2
  74.  
  75. select_data($c1); // Le résultat de c2 est retourné
  76.  
  77. delete_data($c1); // Effacement de toute la table via c1
  78. select_data($c1); // Aucune ligne de trouvée
  79. select_data($c2); // Aucune ligne de trouvée
  80. commit($c1);      // Validation via c1
  81.  
  82. select_data($c1); // Aucune ligne de trouvée
  83. select_data($c2); // Aucune ligne de trouvée
  84.  
  85. drop_table($c1);  
  86. echo "</pre>";  
  87. ?> 

Notes

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. En fait, 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, dont les transactions sont isolées, vous devez utiliser la fonction oci_new_connect() à la place.

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

Fonctions OCI8
PHP Manual

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique