cubrid_get_server_info — Funktion · PHP-Referenz

Signatur

cubrid_get_server_info(resource $conn_identifier): string

Beschreibung

cubrid_get_server_info() liefert die Versionszeichenkette des CUBRID-Datenbankservers, mit dem die übergebene Verbindung aufgebaut wurde. Die zurückgegebene Zeichenkette enthält typischerweise die vollständige Versionsnummer des Servers, z. B. 10.2.0.8368.

Die Funktion ist nützlich, wenn eine Anwendung server-seitige Funktionen nutzen möchte, die erst ab einer bestimmten CUBRID-Version verfügbar sind. Durch den Versionsvergleich können entsprechende Code-Pfade bedingt aktiviert oder deaktiviert werden.

Ein typischer Einsatzbereich ist das Logging von Verbindungsinformationen zu Diagnosezwecken oder die Überprüfung der Serverversion beim Anwendungsstart, um sicherzustellen, dass die Mindestanforderungen erfüllt sind.

Parameter

Name	Typ	Default	Beschreibung
$conn_identifier Pflicht	resource		Eine gültige CUBRID-Verbindungsressource, die zuvor mit `cubrid_connect()` oder `cubrid_connect_with_url()` erzeugt wurde.

Rückgabewert

Typ

string

Beschreibung

Gibt die Versionszeichenkette des CUBRID-Servers zurück (z. B. 10.2.0.8368). Im Fehlerfall wird false zurückgegeben.

Beispiele

Serverversion ausgeben

<?php
$conn = cubrid_connect('localhost', 33000, 'demodb', 'dba', '');

if ($conn) {
    $serverVersion = cubrid_get_server_info($conn);
    echo 'CUBRID Server-Version: ' . $serverVersion . PHP_EOL;
    cubrid_disconnect($conn);
} else {
    echo 'Verbindung fehlgeschlagen.' . PHP_EOL;
}

CUBRID Server-Version: 10.2.0.8368

Mindestversion prüfen

<?php
$conn = cubrid_connect('localhost', 33000, 'demodb', 'dba', '');

if ($conn) {
    $serverVersion = cubrid_get_server_info($conn);
    // Versionsstring in vergleichbare Zahl umwandeln
    $parts = explode('.', $serverVersion);
    $major = (int)($parts[0] ?? 0);
    $minor = (int)($parts[1] ?? 0);

    if ($major > 9 || ($major === 9 && $minor >= 3)) {
        echo 'Server unterstützt erweiterte Funktionen.' . PHP_EOL;
    } else {
        echo 'Server-Version zu alt. Mindestens 9.3 erforderlich.' . PHP_EOL;
    }

    cubrid_disconnect($conn);
}

Server unterstützt erweiterte Funktionen.

// Wichtig · Fallstricke

Stellen Sie sicher, dass die Verbindungsressource gültig und nicht bereits geschlossen wurde, bevor Sie cubrid_get_server_info() aufrufen, da sonst kein sinnvoller Rückgabewert erwartet werden kann.

Die CUBRID-Erweiterung für PHP ist nicht standardmäßig aktiviert und muss explizit installiert und in der php.ini geladen werden (extension=cubrid).

Siehe auch

cubrid_connect cubrid_connect_with_url cubrid_get_client_info cubrid_disconnect