(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_new_connect — Connect to the Oracle server using a unique connection
$username,$password,$connection_string = null,$encoding = "",$session_mode = OCI_DEFAULTEstablishes a new connection to an Oracle server and logs on.
Unlike oci_connect() and oci_pconnect(), oci_new_connect() does not cache connections and will always return a brand-new freshly opened connection handle. This is useful if your application needs transactional isolation between two sets of queries.
usernameThe Oracle user name.
password
The password for username.
connection_string
Beinhaltet die Oracle-Instanz, mit der verbunden werden
soll. Dies kann eine » Easy-Connect-Zeichenkette, ein
Connect-Name aus der Datei tnsnames.ora oder der Name
einer lokalen Oracle-Instanz sein.
Wenn dies nicht angegebe wird oder
null ist, verwendet PHP Umgebungsvariablen wie TWO_TASK
(unter Linux), LOCAL (unter Windows) oder
ORACLE_SID um die Oracle-Instanz zu
ermitteln, mit der verbunden werden soll.
Um die benannte Easy Connect Methode zu verwenden, muss PHP gegen die
Clientbibliotheken von Oracle 10g oder höher gelinkt
sein. Die Easy-Connect-Zeichenkette für Oracle 10g hat
den Aufbau: [//]host_name[:port][/service_name]. Für
Oracle 11g ist die Syntax:
[//]host_name[:port][/service_name][:server_type][/instance_name].
Weitere Optionen wurden mit Oracle 19c eingeführt, darunter die timeout- und
die keep-alive-Einstellungen. Siehe dazu die Oracle-Dokumentation. Die
Servicenamen können ermittelt werden, indem man das Oracle-Hilfswerkzeug
lsnrctl status auf dem Datenbankserver ausführt.
Die Datei tnsnames.ora kann sich im Oracle Net Suchpfad
befinden, welcher
/der/pfad/zu/instantclient/network/admin,
$ORACLE_HOME/network/admin sowie
/etc beinhaltet. Alternativ kann
TNS_ADMIN so gesetzt werden, dass
$TNS_ADMIN/tnsnames.ora gelesen wird. Es muss
sichergestellt sein, dass der Webserver eine Leseberechtigung für die Datei
besitzt.
encodingBestimmt den Zeichensatz, der von den Oracle Client Bibliotheken verwendet wird. Dieser Zeichensatz muss nicht dem von der Datenbank verwendeten Zeichensatz entsprechen. Wenn diese nicht übereinstimmen, wird Oracle bestmöglich versuchen, die Daten in den Datenbankzeichensatz zu übersetzen. Abhängig von den Zeichensätzen kann dies zu unbrauchbaren Ergebnissen führen. Diese Konvertierung führt auch zu einem erhöhten Zeitbedarf.
Falls nicht angegeben, werden
die Oracle Client Bibliotheken versuchen, den Zeichensatz aus der
Umgebungsvariablen NLS_LANG auszulesen.
Die Übergabe dieses Parameters verringert die Zeit für den Verbindungsaufbau.
session_modeDieser
Parameter ist seit PHP 5 (PECL OCI8 1.1) verfügbar und akzeptiert
die folgenden Werte: OCI_DEFAULT,
OCI_SYSOPER und OCI_SYSDBA.
Falls entweder OCI_SYSOPER oder
OCI_SYSDBA angegeben wurden wird diese Funktion
versuchen die priviligierte Verbindung mit externen Credentials aufzubauen.
Um diese einzuschalten muss man
oci8.privileged_connect
auf On setzen.
PHP 5.3 (PECL OCI8 1.3.4) hat den Wert OCI_CRED_EXT
eingeführt. Dies konfiguriert Oracle dazu eine externe oder
Os-Authentifizierung vorzunehmen, welche in der Datenbank konfiguriert
werden muss. Der Schalter OCI_CRED_EXT kann nur mit
dem Benutzernamen "/" und einem leeren Passwort verwendet werden.
oci8.privileged_connect
kann entweder On oder Off sein.
OCI_CRED_EXT kann mit
OCI_SYSOPER oder
OCI_SYSDBA kombiniert werden.
OCI_CRED_EXT ist auf Windows-Systemen aus
sicherheitsgründen nicht unterstützt.
Returns a connection identifier or false on error.
| Version | Beschreibung |
|---|---|
| 8.0.0, PECL OCI8 3.0.0 |
connection_string is now nullable.
|
The following demonstrates how you can separate connections.
Beispiel #1 oci_new_connect() example
<?php
// create table mytab (mycol number);
function query($name, $c)
{
echo "Querying $name\n";
$s = oci_parse($c, "select * from mytab");
oci_execute($s, OCI_NO_AUTO_COMMIT);
$row = oci_fetch_array($s, OCI_ASSOC);
if (!$row) {
echo "No rows\n";
} else {
do {
foreach ($row as $item)
echo $item . " ";
echo "\n";
} while (($row = oci_fetch_array($s, OCI_ASSOC)) != false);
}
}
$c1 = oci_connect("hr", "welcome", "localhost/orcl");
$c2 = oci_new_connect("hr", "welcome", "localhost/orcl");
$s = oci_parse($c1, "insert into mytab values(1234)");
oci_execute($s, OCI_NO_AUTO_COMMIT);
query("basic connection", $c1);
query("new connection", $c2);
oci_commit($c1);
query("new connection after commit", $c2);
// Output is:
// Querying basic connection
// 1234
// Querying new connection
// No rows
// Querying new connection after commit
// 1234
?>See oci_connect() for further examples of parameter usage.