Start · Sprachen · PHP · Referenz · cubrid_get_client_info

cubrid_get_client_info

Funktion

Gibt die Version der installierten CUBRID-Client-Bibliothek als Zeichenkette zurück.

seit PHP 8.3.1 Kategorie: db

Signatur

cubrid_get_client_info(): string

Beschreibung

cubrid_get_client_info() liefert Informationen über die Version der auf dem Server installierten CUBRID-Client-Bibliothek (CCI – CUBRID C Interface). Die Funktion benötigt keine Parameter und keine aktive Datenbankverbindung.

Der Rückgabewert ist eine Zeichenkette im Format Major.Minor.Patch, z. B. 10.2.0.8884. Diese Information ist nützlich, um Kompatibilitätsprobleme zwischen Client- und Server-Version zu diagnostizieren oder in Anwendungsprotokollen festzuhalten.

Die Funktion ist besonders in Entwicklungs- und Diagnose-Umgebungen hilfreich, wenn sichergestellt werden muss, dass die korrekte CUBRID-Erweiterung geladen ist, oder wenn Client- und Server-Version abgeglichen werden sollen.

Rückgabewert

Typ
string
Beschreibung
Gibt die Version der CUBRID-Client-Bibliothek als Zeichenkette zurück, z. B. "10.2.0.8884". Es gibt keinen Fehlerfall – die Funktion gibt immer eine Zeichenkette zurück, sofern die CUBRID-Erweiterung geladen ist.

Beispiele

Client-Version ausgeben

<?php
// Gibt die Version der CUBRID-Client-Bibliothek aus
$clientVersion = cubrid_get_client_info();
echo "CUBRID Client-Version: " . $clientVersion . PHP_EOL;
CUBRID Client-Version: 10.2.0.8884

Client- und Server-Version vergleichen

<?php
// Verbindung zur CUBRID-Datenbank herstellen
$conn = cubrid_connect("localhost", 33000, "demodb", "dba", "");

if ($conn) {
    $clientInfo = cubrid_get_client_info();
    $serverInfo = cubrid_get_server_info($conn);

    echo "Client-Version: " . $clientInfo . PHP_EOL;
    echo "Server-Version: " . $serverInfo . PHP_EOL;

    if ($clientInfo !== $serverInfo) {
        echo "Hinweis: Client- und Server-Version weichen voneinander ab!" . PHP_EOL;
    } else {
        echo "Client- und Server-Version stimmen überein." . PHP_EOL;
    }

    cubrid_disconnect($conn);
} else {
    echo "Verbindung zur Datenbank fehlgeschlagen." . PHP_EOL;
}
Client-Version: 10.2.0.8884 Server-Version: 10.2.0.8884 Client- und Server-Version stimmen überein.

// Wichtig · Fallstricke

Die Funktion ist nur verfügbar, wenn die CUBRID PHP-Erweiterung (php_cubrid.so bzw. php_cubrid.dll) installiert und aktiviert ist. Ohne diese Erweiterung führt der Aufruf zu einem fatalen Fehler. Prüfen Sie mit extension_loaded('cubrid'), ob die Erweiterung verfügbar ist, bevor Sie die Funktion aufrufen.