Signatur
Beschreibung
ocilogoff() ist ein veralteter Alias für oci_close() und schließt eine zuvor mit oci_connect(), oci_pconnect() oder oci_new_connect() geöffnete Oracle-OCI8-Verbindung.
Die Funktion dekrementiert den internen Referenzzähler der Verbindung. Eine persistente Verbindung (oci_pconnect()) wird dabei nicht wirklich getrennt, sondern lediglich für die Wiederverwendung freigegeben. Nicht-persistente Verbindungen werden geschlossen, sobald der Referenzzähler null erreicht.
Wichtig: ocilogoff() gilt seit PHP 5.4.0 als veraltet (deprecated) und wurde in neueren Versionen entfernt. Neuer Code sollte ausschließlich oci_close() verwenden.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $connection Pflicht | resource | Eine gültige OCI8-Verbindungsressource, wie sie von oci_connect(), oci_pconnect() oder oci_new_connect() zurückgegeben wird. |
Rückgabewert
true bei Erfolg zurück, false bei einem Fehler (z. B. wenn eine ungültige Ressource übergeben wird).Beispiele
Oracle-Verbindung öffnen und schließen (Legacy-Code)
<?php
// Veralteter Stil – nur zur Illustration
$conn = ocilogon('scott', 'tiger', 'mydb');
if (!$conn) {
$e = ocierror();
trigger_error(htmlspecialchars($e['message']), E_USER_ERROR);
}
echo "Verbindung hergestellt.\n";
// Verbindung schließen (veraltet)
ocilogoff($conn);
echo "Verbindung geschlossen.\n";Moderner Ersatz mit oci_close()
<?php
// Empfohlene, aktuelle Vorgehensweise
$conn = oci_connect('scott', 'tiger', 'mydb');
if (!$conn) {
$e = oci_error();
trigger_error(htmlspecialchars($e['message']), E_USER_ERROR);
}
echo "Verbindung hergestellt.\n";
// Korrekte, moderne Methode zum Schließen
oci_close($conn);
echo "Verbindung sauber geschlossen.\n";// Wichtig · Fallstricke
Deprecation-Hinweis: ocilogoff() ist ein veralteter Alias und sollte in keinem neuen Code mehr verwendet werden. Seit PHP 5.4.0 wird bei der Verwendung eine E_DEPRECATED-Warnung ausgegeben. Verwende stattdessen immer oci_close().
Bei persistenten Verbindungen via oci_pconnect() wird die zugrundeliegende Datenbankverbindung beim Aufruf von ocilogoff() bzw. oci_close() nicht sofort getrennt — sie bleibt im Verbindungspool erhalten und wird beim nächsten passenden Aufruf wiederverwendet.