Signatur
Beschreibung
ociserverversion() ist ein veralteter Alias der Funktion oci_server_version() und liefert einen String mit Informationen zur Version des verbundenen Oracle-Datenbankservers. Die zurückgegebene Zeichenkette enthält typischerweise Angaben zur Oracle-Datenbankversion, dem Betriebssystem und anderen Serverinformationen.
Die Funktion ist nützlich, wenn zur Laufzeit geprüft werden soll, welche Oracle-Version auf dem Server aktiv ist – etwa um versionsspezifische SQL-Syntax oder Features zu verwenden. In modernem PHP-Code sollte jedoch ausschließlich oci_server_version() verwendet werden.
Achtung: Aliasfunktionen mit dem Präfix oci (ohne Unterstrich) gelten seit PHP 8.0 als veraltet (deprecated) und können in zukünftigen PHP-Versionen entfernt werden. Es wird dringend empfohlen, auf die nicht-alias Variante oci_server_version() umzusteigen.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $connection Pflicht | resource | Eine gültige OCI8-Verbindungsressource, die zuvor mit oci_connect(), oci_pconnect() oder oci_new_connect() erstellt wurde. |
Rückgabewert
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production. Im Fehlerfall wird false zurückgegeben.Beispiele
Oracle-Serverversion abfragen (veraltet)
<?php
// Verbindung zur Oracle-Datenbank herstellen
$conn = oci_connect('benutzer', 'passwort', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
// Veralteten Alias verwenden (nicht empfohlen)
$version = ociserverversion($conn);
if ($version !== false) {
echo "Oracle-Serverversion: " . $version . "\n";
} else {
echo "Versionsabfrage fehlgeschlagen.\n";
}
oci_close($conn);Empfohlene Variante mit oci_server_version()
<?php
// Moderne, empfohlene Variante
$conn = oci_connect('benutzer', 'passwort', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
// Bevorzugter Funktionsname ohne Alias
$version = oci_server_version($conn);
if ($version !== false) {
echo "Oracle-Serverversion: " . $version . "\n";
// Versionsnummer extrahieren und vergleichen
if (strpos($version, '19c') !== false) {
echo "Oracle 19c erkannt – JSON-Funktionen verfügbar.\n";
}
} else {
echo "Versionsabfrage fehlgeschlagen.\n";
}
oci_close($conn);// Wichtig · Fallstricke
Deprecated: ociserverversion() ist ein veralteter Alias und sollte in neuem Code nicht mehr verwendet werden. Seit PHP 8.0 erzeugen veraltete OCI8-Aliasfunktionen eine E_DEPRECATED-Warnung. Verwende stattdessen oci_server_version().
Der zurückgegebene Versionsstring ist für menschliche Augen formatiert und nicht für maschinelles Parsen optimiert. Für zuverlässige Versionsvergleiche empfiehlt sich die Verwendung regulärer Ausdrücke oder version_compare() nach dem Extrahieren der eigentlichen Versionsnummer.