oci_new_collection
<<<		 oci_new_connect oci_new_cursor
>>>
6.27 Fonctions Oracle
6 Référence des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Configuration à l'exécution
. Constantes pré-définies
. Exemples
. Gestion de la connexion
. Types de données supportées par le driver
. oci_bind_by_name
. oci_cancel
. oci_close
. OCI-Collection->append
. OCI-Collection->assign
. OCI-Collection->assignElem
. OCI-Collection->free
. OCI-Collection->getElem
. OCI-Collection->max
. OCI-Collection->size
. OCI-Collection->trim
. oci_commit
. oci_connect
. oci_define_by_name
. oci_error
. oci_execute
. oci_fetch_all
. oci_fetch_array
. oci_fetch_assoc
. oci_fetch_object
. oci_fetch_row
. oci_fetch
. oci_field_is_null
. oci_field_name
. oci_field_precision
. oci_field_scale
. oci_field_size
. oci_field_type_raw
. oci_field_type
. oci_free_statement
. oci_internal_debug
. OCI-Lob->append
. OCI-Lob->close
. oci_lob_copy
. OCI-Lob->eof
. OCI-Lob->erase
. OCI-Lob->export
. OCI-Lob->flush
. OCI-Lob->free
. OCI-Lob->getBuffering
. OCI-Lob->import
. oci_lob_is_equal
. OCI-Lob->load
. OCI-Lob->read
. OCI-Lob->rewind
. OCI-Lob->save
. OCI-Lob->saveFile
. OCI-Lob->seek
. OCI-Lob->setBuffering
. OCI-Lob->size
. OCI-Lob->tell
. OCI-Lob->truncate
. OCI-Lob->write
. OCI-Lob->writeTemporary
. OCI-Lob->writeToFile
. oci_new_collection
->oci_new_connect
. oci_new_cursor
. oci_new_descriptor
. oci_num_fields
. oci_num_rows
. oci_parse
. oci_password_change
. oci_pconnect
. oci_result
. oci_rollback
. oci_server_version
. oci_set_prefetch
. oci_statement_type
. ocibindbyname
. ocicancel
. ocicloselob
. ocicollappend
. ocicollassign
. ocicollassignelem
. ocicollgetelem
. ocicollmax
. ocicollsize
. ocicolltrim
. ocicolumnisnull
. ocicolumnname
. ocicolumnprecision
. ocicolumnscale
. ocicolumnsize
. ocicolumntype
. ocicolumntyperaw
. ocicommit
. ocidefinebyname
. ocierror
. ociexecute
. ocifetch
. ocifetchinto
. ocifetchistatement
. ocifreecollection
. ocifreecursor
. ocifreedesc
. ocifreestatement
. ociinternaldebug
. ociloadlob
. ocilogoff
. ocilogon
. ocinewcollection
. ocinewcursor
. ocinewscriptor
. ocinlogon
. ocinumcols
. ociparse
. ociplogon
. ociresult
. ocirollback
. ocirowcount
. ocisavelob
. ocisavelobfile
. ociserverversion
. ocisetprefetch
. ocistatementtype
. ociwritelobtofile
. ociwritetemporarylob

6.27.64 oci_new_connect()Etablit une nouvelle connexion à Oracle

[ Exemples avec oci_new_connect ]   PHP 5

resource  oci_new_connect ( string   username , string   password , string   db , string   charset , int   session_mode )

oci_new_connect établit une nouvelle connexion sur un serveur Oracle et s'y identifie. Contrairement aux fonctions oci_connect et oci_pconnect , oci_new_connect ne met pas en cache les connexions et retourne toujours un gestionnaire de connexion nouvellement ouvert. Ceci est très utile si votre application a besoin d'une isolation transactionnelle entre deux jeux de requêtes.

Le troisième paramètre, optionnel, db peut contenir l'instance locale d'Oracle ou un nom disponible dans le fichier tnsnames.ora . Si le troisième paramètre n'est pas fourni, PHP va chercher la valeur dans les variables d'environnement ORACLE_SID et TWO_TASK pour déterminer le nom de l'instance locale d'Oracle, et la localisation du fichier tnsnames.ora .

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_new_connect tentera d'établir une connexion privilégiée en utilisant les 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 d'Oracle, vous pouvez utiliser les méthodes de nommage facilitant la connexion décrites 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. Mais si vous voulez utiliser l'ancienne façon de nommage, vous devez définir soit ORACLE_HOME , soit TNS_ADMIN .

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.

Voici comment séparer des transactions.
Exemple avec oci_new_connect

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

$c1 = oci_connect("scott", "tiger", $db);
$c2 = oci_new_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);

select_data($c1);   
select_data($c2);   

rollback($c1);      

select_data($c1);   
select_data($c2);   

insert_data($c2);   
commit($c2);        

select_data($c1);   

delete_data($c1);   
select_data($c1);   
select_data($c2);   
commit($c1);        

select_data($c1);
select_data($c2);

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

oci_new_connect retourne FALSE en cas d'erreur.

Note

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

Voir aussi oci_connect et oci_pconnect .

<< oci_new_connect >>
oci_new_collection Fonctions Oracle oci_new_cursor